C# Rundung (Wie es für Entwickler funktioniert)

Warum runde Zahlen?

1. Einfachheit: Gerundete Zahlen sind oft leichter zu lesen und zu verstehen.
2. Präzision: In einigen Fällen ist es effizienter, mit gerundeten Werten statt mit exakten Werten zu arbeiten, insbesondere in Kontexten wie Währungsberechnungen.

Gängige Rundungs-Szenarien

1. Nächste Ganzzahl: Runden Sie einen Dezimalwert auf die nächstgelegene ganze Zahl.
2. Angegebene Anzahl von Dezimalstellen: Runden Sie eine Zahl auf eine bestimmte Anzahl von Dezimalstellen, wie zum Beispiel 15.678 auf zwei Dezimalstellen zu runden, was 15.68 ergibt.

Aufrunden auf den nächstliegenden ganzzahligen Wert

Die einfachste Form der Math.Round Methode rundet einen double-Wert auf den nächsten ganzzahligen Wert. Wenn die gegebene Zahl genau zwischen zwei Ganzzahlen liegt, wird sie auf die nächstgelegene gerade Zahl gerundet, was oft als 'Banker's Rounding' bezeichnet wird.

double originalValue = 4.5;
double roundedValue = Math.Round(originalValue);
Console.WriteLine($"Original: {originalValue}, Rounded: {roundedValue}");

double originalValue = 4.5;
double roundedValue = Math.Round(originalValue);
Console.WriteLine($"Original: {originalValue}, Rounded: {roundedValue}");

Im obigen Beispiel ist 4.5 gleich weit entfernt von 4 und 5. Da 4 die nächste gerade Zahl ist, gibt die Methode 4 zurück.

Rundung auf eine bestimmte Anzahl von Nachkommastellen

Sie können auch einen double-Präzisions-Gleitkommawert auf eine bestimmte Anzahl von Dezimalstellen runden, indem Sie ein zusätzliches Argument verwenden:

double value = 7.34567;
double rounded = Math.Round(value, 2); // Rounds to two decimal places
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

double value = 7.34567;
double rounded = Math.Round(value, 2); // Rounds to two decimal places
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

Die Methode rundet den ursprünglichen Wert 7.34567 auf 7.35, da wir angegeben haben, auf zwei Dezimalstellen zu runden.

Standard-Rundung

Standardmäßig rundet Math.Round Mittelwerte auf die nächste gerade Zahl.

double valueOne = Math.Round(4.5);  // Rounded to 4
double valueTwo = Math.Round(5.5);  // Rounded to 6

double valueOne = Math.Round(4.5);  // Rounded to 4
double valueTwo = Math.Round(5.5);  // Rounded to 6

Angabe eines MidpointRounding Modus

Um mehr Kontrolle über die Rundungsoperation bei Mittelwerten zu haben, können Sie einen bestimmten MidpointRounding Modus als Parameter angeben:

double value = 5.5;
double rounded = Math.Round(value, 0, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

double value = 5.5;
double rounded = Math.Round(value, 0, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {value}, Rounded: {rounded}");

In diesem Beispiel sorgt der MidpointRounding.AwayFromZero Modus dafür, dass die Zahl auf 6 gerundet wird.

Aufrunden

Um immer auf die nächste ganze Zahl aufzurunden, können Sie die Math.Ceiling Methode verwenden:

double value = 4.3;
double roundedUp = Math.Ceiling(value);
Console.WriteLine($"Original: {value}, Rounded Up: {roundedUp}");

double value = 4.3;
double roundedUp = Math.Ceiling(value);
Console.WriteLine($"Original: {value}, Rounded Up: {roundedUp}");

Die Dezimalzahl 4.3 rundet sich auf 5 auf.

Abrunden

Im Gegensatz dazu wird beim Abrunden auf den nächsten ganzzahligen Wert die Math.Floor Methode verwendet:

double value = 4.7;
double roundedDown = Math.Floor(value);
Console.WriteLine($"Original: {value}, Rounded Down: {roundedDown}");

double value = 4.7;
double roundedDown = Math.Floor(value);
Console.WriteLine($"Original: {value}, Rounded Down: {roundedDown}");

Die Dezimalzahl 4.7 rundet sich auf 4 ab.

Parsing und Rundung

Hier ist ein Beispiel, wie man eine Zeichenfolge, die eine Dezimalzahl enthält, rundet:

string originalString = "4.5678";
double parsedValue = double.Parse(originalString);
double rounded = Math.Round(parsedValue, 2); // Rounds to two decimal places
string roundedString = rounded.ToString();
Console.WriteLine($"Original: {originalString}, Rounded: {roundedString}");

string originalString = "4.5678";
double parsedValue = double.Parse(originalString);
double rounded = Math.Round(parsedValue, 2); // Rounds to two decimal places
string roundedString = rounded.ToString();
Console.WriteLine($"Original: {originalString}, Rounded: {roundedString}");

Original: 4.5678, Gerundet: 4.57

Beispiel Rundung der Währung

Das folgende Beispiel demonstriert das Runden eines Dezimalwerts, der Währung darstellt:

decimal originalValue = 1234.5678m;
decimal roundedValue = Math.Round(originalValue, 2, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {originalValue:C}, Rounded: {roundedValue:C}");

decimal originalValue = 1234.5678m;
decimal roundedValue = Math.Round(originalValue, 2, MidpointRounding.AwayFromZero);
Console.WriteLine($"Original: {originalValue:C}, Rounded: {roundedValue:C}");

Der obige Code rundet den Wert auf zwei Dezimalstellen und entspricht damit den meisten Währungsstandards.

Gängige Fallstricke

• Doppelte Präzision: Der Typ double kann Dezimalzahlen möglicherweise nicht immer genau darstellen, was zu unerwarteten Rundungsergebnissen führt. Die Verwendung des Dekimaltyps kann dies abmildern.
• Falscher MidpointRounding-Modus: Stellen Sie sicher, dass Sie den richtigen MidpointRounding Modus für Ihre spezifischen Anforderungen verwenden. Eine falsche Verwendung dieser Modi kann zu Rundungsfehlern führen.

Wie man debuggt

Nutzen Sie Werkzeuge wie Logging und Haltepunkte, um den Wert vor und nach dem Runden zu verfolgen. Durch das Überprüfen des Originalwerts und der an die Rundungsmethode übergebenen Parameter können in der Regel Unstimmigkeiten aufgedeckt werden.

IronPDF

IronPDF ist eine robuste C#-Bibliothek, die für die Erstellung, Bearbeitung und Verwaltung von PDFs aus HTML entwickelt wurde. Stellen Sie sich ein Szenario vor, in dem Sie nach der Durchführung von Rundungsoperationen einen Bericht im PDF-Format erstellen müssen. IronPDF kann Ihren C#-Code mühelos in hochwertige PDFs umwandeln.

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Sample data for invoice
        decimal itemPrice = 49.995m; // Item price before rounding
        decimal taxRate = 0.18m;     // 18% tax rate

        // Round price to 2 decimal places
        decimal roundedPrice = Math.Round(itemPrice, 2);

        // Calculate and round the tax amount
        decimal taxAmount = Math.Round(roundedPrice * taxRate, 2);

        // Calculate the total amount
        decimal totalAmount = Math.Round(roundedPrice + taxAmount, 2);

        // Create simple HTML content for the PDF
        string htmlContent = $@"
            <h1>Invoice</h1>
            <p>Item Price: ${roundedPrice}</p>
            <p>Tax (18%): ${taxAmount}</p>
            <hr>
            <h2>Total Amount: ${totalAmount}</h2>
        ";

        // Generate PDF using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF file
        pdfDocument.SaveAs("Invoice.pdf");

        Console.WriteLine("PDF invoice generated successfully with rounded values.");
    }
}

using IronPdf;
using System;

class Program
{
    static void Main(string[] args)
    {
        // Sample data for invoice
        decimal itemPrice = 49.995m; // Item price before rounding
        decimal taxRate = 0.18m;     // 18% tax rate

        // Round price to 2 decimal places
        decimal roundedPrice = Math.Round(itemPrice, 2);

        // Calculate and round the tax amount
        decimal taxAmount = Math.Round(roundedPrice * taxRate, 2);

        // Calculate the total amount
        decimal totalAmount = Math.Round(roundedPrice + taxAmount, 2);

        // Create simple HTML content for the PDF
        string htmlContent = $@"
            <h1>Invoice</h1>
            <p>Item Price: ${roundedPrice}</p>
            <p>Tax (18%): ${taxAmount}</p>
            <hr>
            <h2>Total Amount: ${totalAmount}</h2>
        ";

        // Generate PDF using IronPDF
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF file
        pdfDocument.SaveAs("Invoice.pdf");

        Console.WriteLine("PDF invoice generated successfully with rounded values.");
    }
}

IronXL

IronXL bietet Funktionen zum Arbeiten mit Excel-Dateien und ermöglicht es C#-Entwicklern, Excel-Tabellen reibungslos zu lesen, zu schreiben und zu bearbeiten. Mit IronXL können Sie Dezimal- oder Double-Daten aus Excel-Tabellen abrufen und Rundungsoperationen in C# durchführen.

IronOCR

IronOCR ist eine fortschrittliche optische Zeichenerkennungsbibliothek für C#, die Text aus Bildern und PDFs erkennen und extrahieren kann. Angenommen, Sie haben gescannte Dokumente oder Bilder, die numerische Daten enthalten. Mit IronOCR können Sie diese Daten extrahieren und in C# verarbeiten oder runden.

IronBarcode

IronBarcode ist ein leistungsstarkes Werkzeug zum Generieren, Lesen und Klassifizieren von Barcodes und QR-Codes in .NET. In Kontexten, in denen gerundete Daten in Barcodes kodiert werden müssen (zum Beispiel Produktpreise in einer Einzelhandelsanwendung), kann IronBarcode von unschätzbarem Wert sein.