Complex.ToString Methode

Referenz

Definition

Namespace:: System.Numerics

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wandelt den Wert einer komplexen Zahl in die entsprechende Zeichenfolgendarstellung um.

Überlädt

ToString(String, IFormatProvider)	Wandelt den Wert der aktuellen komplexen Zahl in die entsprechende Zeichenfolgendarstellung in kartesischer Form um, indem die angegebenen Format- und kulturspezifischen Formatinformationen für die tatsächlichen und imaginären Teile verwendet werden.
ToString(String)	Wandelt den Wert der aktuellen komplexen Zahl in die entsprechende Zeichenfolgendarstellung in kartesischer Form um, indem das angegebene Format für die tatsächlichen und imaginären Teile verwendet wird.
ToString(IFormatProvider)	Wandelt den Wert der aktuellen komplexen Zahl mithilfe der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung in kartesischer Form um.
ToString()	Wandelt den Wert der aktuellen komplexen Zahl in die entsprechende Zeichenfolgendarstellung in kartesischer Form um.

ToString(String, IFormatProvider)

Quelle:: Complex.cs

Quelle:: Complex.cs

Quelle:: Complex.cs

Wandelt den Wert der aktuellen komplexen Zahl in die entsprechende Zeichenfolgendarstellung in kartesischer Form um, indem die angegebenen Format- und kulturspezifischen Formatinformationen für die tatsächlichen und imaginären Teile verwendet werden.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string format, IFormatProvider provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format: String

Eine standard- oder benutzerdefinierte zahlenformatige Zeichenfolge.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form, wie durch format und providerangegeben.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird ein Array von komplexen Zahlen erstellt und mit mehreren Standardformatzeichenfolgen sowie CultureInfo Objekten angezeigt, die die Kulturen Englisch - USA ("en-US") und Französisch - Frankreich ("fr-FR") darstellen.

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      CultureInfo[] cultures = { new CultureInfo("en-US"),
                                 new CultureInfo("fr-FR") };
      string[] formats = { "F2", "N2", "G5" };

      foreach (Complex c1 in c)
      {
         foreach (string format in formats)
         {
            Console.Write("{0} format string:   ", format);
            foreach (CultureInfo culture in cultures)
               Console.Write("{0} ({1})    ", c1.ToString(format, culture), culture.Name);

            Console.WriteLine();
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    F2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    N2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    G5 format string:   (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//
//    F2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    N2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    G5 format string:   (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//
//    F2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    N2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    G5 format string:   (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//
//    F2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    N2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    G5 format string:   (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

open System.Globalization
open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let cultures = [ CultureInfo "en-US"; CultureInfo "fr-FR" ]
let formats = [ "F2"; "N2"; "G5" ]

for c1 in c do
    for format in formats do
        for culture in cultures do
            printf $"{format} format string: {c1.ToString(format, culture)} ({culture.Name})    "

        printfn ""

    printfn ""
// The example displays the following output:
//    F2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    N2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    G5 format string:   (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//
//    F2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    N2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    G5 format string:   (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//
//    F2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    N2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    G5 format string:   (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//
//    F2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    N2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    G5 format string:   (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      Dim cultures() As CultureInfo = { New CultureInfo("en-US"), 
                                        New CultureInfo("fr-FR") } 
      Dim formats() As String = { "F2", "N2", "G5" } 

      For Each c1 As Complex In c
         For Each format As String In formats
            Console.Write("{0} format string:   ", format)
            For Each culture As CultureInfo In cultures
               Console.Write("{0} ({1})    ", c1.ToString(format, culture), 
                                              culture.Name)
            Next
            Console.WriteLine()
         Next
         Console.WriteLine()
      Next                          
   End Sub
End Module
' The example displays the following output:
'    F2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
'    N2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
'    G5 format string:   (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
'    
'    F2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
'    N2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
'    G5 format string:   (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
'    
'    F2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
'    N2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
'    G5 format string:   (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
'    
'    F2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
'    N2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
'    G5 format string:   (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

Hinweise

Die Zeichenfolgendarstellung der von dieser Methode zurückgegebenen komplexen Zahl zeigt die Zahl mithilfe der kartesischen Koordinaten in der Form <a; b> (oder (a, b) in .NET 7 und früheren Versionen) an, wobei ein der reale Teil der komplexen Zahl ist, und b ist der imaginäre Teil. Sowohl eine als auch b werden mithilfe der durch formatangegebenen Formatzeichenfolge formatiert. Der format Parameter kann ein beliebiger gültiger numerischer Standardformatbezeichner oder eine beliebige Kombination von benutzerdefinierten Zahlenformatbezeichnern sein. Wenn format gleich String.Empty ist oder nullist, werden die realen und imaginären Teile der komplexen Zahl mit dem allgemeinen Formatbezeichner ("G") formatiert. Wenn format ein anderer Wert ist, löst die Methode eine FormatExceptionaus.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Artikeln ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatzeichenfolgen finden Sie unter standard numeric format strings und Custom Numeric Format Strings.
Weitere Informationen zur Formatierung in .NET finden Sie unter Formatierungstypen.

Der provider-Parameter ist eine IFormatProvider Implementierung. Die GetFormat-Methode gibt ein NumberFormatInfo-Objekt zurück, das kulturspezifische Informationen zum Format der realen und imaginären Zahlen in der zurückgegebenen Zeichenfolge bereitstellt. Je nach format Parameter steuert dieses Objekt Symbole wie das negative Zeichen, das Gruppentrennzeichen und das Dezimalkommasymbol in der Ausgabezeichenfolge. Wenn providernullist, wird die zurückgegebene Zeichenfolge mithilfe des NumberFormatInfo Objekts der aktuellen Kultur formatiert.

Der provider-Parameter kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das die Kultur darstellt, die Formatierungsinformationen bereitstellt
Das NumberFormatInfo-Objekt, das Formatierungsinformationen bereitstellt.
Ein benutzerdefiniertes Objekt, das die IFormatProvider Schnittstelle implementiert. Die GetFormat-Methode gibt das NumberFormatInfo-Objekt zurück, das Formatierungsinformationen bereitstellt.

Weitere Informationen

Gilt für:

ToString(String)

Quelle:: Complex.cs

Quelle:: Complex.cs

Quelle:: Complex.cs

Wandelt den Wert der aktuellen komplexen Zahl in die entsprechende Zeichenfolgendarstellung in kartesischer Form um, indem das angegebene Format für die tatsächlichen und imaginären Teile verwendet wird.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parameter

format: String

Eine standard- oder benutzerdefinierte zahlenformatige Zeichenfolge.

Gibt zurück

String

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form.

Ausnahmen

FormatException

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird eine komplexe Zahl initialisiert und mithilfe mehrerer Standardformatzeichenfolgen angezeigt.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      string[] formats = { "F2", "N2", "G5" };

      foreach (Complex c1 in c)
      {
         foreach (string format in formats)
            Console.WriteLine("{0}: {1}    ", format, c1.ToString(format));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       F2: (17.30, 14.10)
//       N2: (17.30, 14.10)
//       G5: (17.3, 14.1)
//
//       F2: (-18.90, 147.20)
//       N2: (-18.90, 147.20)
//       G5: (-18.9, 147.2)
//
//       F2: (13.47, -18.12)
//       N2: (13.47, -18.12)
//       G5: (13.472, -18.115)
//
//       F2: (-11.15, -17.00)
//       N2: (-11.15, -17.00)
//       G5: (-11.154, -17.002)

open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let formats = [ "F2"; "N2"; "G5" ]

for c1 in c do
    for format in formats do
        printf $"{format}: {c1.ToString(format)}    "

    printfn ""
// The example displays the following output:
//       F2: (17.30, 14.10)
//       N2: (17.30, 14.10)
//       G5: (17.3, 14.1)
//
//       F2: (-18.90, 147.20)
//       N2: (-18.90, 147.20)
//       G5: (-18.9, 147.2)
//
//       F2: (13.47, -18.12)
//       N2: (13.47, -18.12)
//       G5: (13.472, -18.115)
//
//       F2: (-11.15, -17.00)
//       N2: (-11.15, -17.00)
//       G5: (-11.154, -17.002)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      Dim formats() As String = { "F2", "N2", "G5" } 
      
      For Each c1 As Complex In c
         For Each format As String In formats
            Console.WriteLine("{0}: {1}    ", format, c1.ToString(format))
         Next
         Console.WriteLine()
      Next                          
   End Sub
End Module
' The example displays the following output:
'       F2: (17.30, 14.10)
'       N2: (17.30, 14.10)
'       G5: (17.3, 14.1)
'       
'       F2: (-18.90, 147.20)
'       N2: (-18.90, 147.20)
'       G5: (-18.9, 147.2)
'       
'       F2: (13.47, -18.12)
'       N2: (13.47, -18.12)
'       G5: (13.472, -18.115)
'       
'       F2: (-11.15, -17.00)
'       N2: (-11.15, -17.00)
'       G5: (-11.154, -17.002)

Hinweise

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Artikeln ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatzeichenfolgen finden Sie unter standard numeric format strings und Custom Numeric Format Strings.
Weitere Informationen zur Formatierung in .NET finden Sie unter Formatierungstypen.

Das Format der zurückgegebenen Zeichenfolge wird durch das NumberFormatInfo-Objekt für die aktuelle Kultur bestimmt. Je nach format Parameter steuert dieses Objekt Symbole wie das negative Zeichen, das Gruppentrennzeichen und das Dezimalkommasymbol in der Ausgabezeichenfolge. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen, rufen Sie die ToString(String, IFormatProvider) Überladung auf.

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Quelle:: Complex.cs

Quelle:: Complex.cs

Quelle:: Complex.cs

Wandelt den Wert der aktuellen komplexen Zahl mithilfe der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung in kartesischer Form um.

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form, wie durch providerangegeben.

Beispiele

Im folgenden Beispiel wird die Zeichenfolgendarstellung mehrerer komplexer Zahlen angezeigt. Das Ergebnis verwendet die Formatierungskonventionen der Kulturen Englisch - USA ("en-US") und Französisch - Frankreich ("fr-FR") .

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      CultureInfo[] cultures = { new CultureInfo("en-US"),
                                 new CultureInfo("fr-FR") };
      foreach (Complex c1 in c)
      {
         foreach (CultureInfo culture in cultures)
            Console.Write("{0} ({1})    ", c1.ToString(culture), culture.Name);

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//       (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//       (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//       (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

open System.Globalization
open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let cultures = [ CultureInfo "en-US"; CultureInfo "fr-FR" ]

for c1 in c do
    for culture in cultures do
        printf $"{c1.ToString culture} ({culture.Name})"

    printfn ""
// The example displays the following output:
//       (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//       (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//       (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//       (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      Dim cultures() As CultureInfo = { New CultureInfo("en-US"), 
                                        New CultureInfo("fr-FR") } 
      For Each c1 As Complex In c
         For Each culture As CultureInfo In cultures
            Console.Write("{0} ({1})    ", c1.ToString(culture), culture.Name)
         Next
         Console.WriteLine()
      Next                          
   End Sub
End Module
' The example displays the following output:
'       (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
'       (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
'       (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
'       (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

Hinweise

Der provider-Parameter ist eine IFormatProvider Implementierung. Die GetFormat-Methode gibt ein NumberFormatInfo-Objekt zurück, das kulturspezifische Informationen zum Format der realen und imaginären Zahlen in der zurückgegebenen Zeichenfolge bereitstellt. Wenn providernullist, wird die zurückgegebene Zeichenfolge mithilfe des NumberFormatInfo Objekts der aktuellen Kultur formatiert.

Der provider-Parameter kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das die Kultur darstellt, die Formatierungsinformationen bereitstellt
Das NumberFormatInfo-Objekt, das Formatierungsinformationen bereitstellt.
Ein benutzerdefiniertes Objekt, das die IFormatProvider Schnittstelle implementiert. Die GetFormat-Methode gibt das NumberFormatInfo-Objekt zurück, das Formatierungsinformationen bereitstellt.

Gilt für:

ToString()

Quelle:: Complex.cs

Quelle:: Complex.cs

Quelle:: Complex.cs

Wandelt den Wert der aktuellen komplexen Zahl in die entsprechende Zeichenfolgendarstellung in kartesischer Form um.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Gibt zurück

String

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form.

Beispiele

Im folgenden Beispiel wird die Zeichenfolgendarstellung mehrerer komplexer Zahlen angezeigt. Die Ausgabe verwendet die Formatierungskonventionen der Englisch - USA ("en-US") Kultur, die in diesem Fall die aktuelle Systemkultur ist.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      foreach (Complex c1 in c)
         Console.WriteLine(c1.ToString());
   }
}
// The example display the following output:
//       (17.3, 14.1)
//       (-18.9, 147.2)
//       (13.472, -18.115)
//       (-11.154, -17.002)

open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

for c1 in c do
    printfn $"{c1.ToString()}"
// The example display the following output:
//       (17.3, 14.1)
//       (-18.9, 147.2)
//       (13.472, -18.115)
//       (-11.154, -17.002)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      For Each c1 As Complex In c
         Console.WriteLine(c1.ToString())
      Next                          
   End Sub
End Module
' The example displays the following output:
'       (17.3, 14.1)
'       (-18.9, 147.2)
'       (13.472, -18.115)
'       (-11.154, -17.002)

Hinweise

Die Standardzeichenfolgendarstellung einer komplexen Zahl zeigt die Zahl mithilfe der kartesischen Koordinaten in der Form <a; b> (oder (a, b) in .NET 7 und früheren Versionen) an, wobei ein der reale Teil der komplexen Zahl ist und b der imaginäre Teil ist. Sowohl eine als auch b werden mit dem allgemeinen Formatbezeichner ("G") und den Konventionen der aktuellen Systemkultur formatiert.

Gilt für:

Teilen über

Complex.ToString Methode

Definition

Überlädt

ToString(String, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ToString(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

ToString()

Gibt zurück

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen