Complex.ToString Methode

Definition

Konvertiert den Wert einer komplexen Zahl in die entsprechende Zeichenfolgendarstellung.

Überlädt

ToString(String, IFormatProvider)

Konvertiert den Wert der aktuellen komplexen Zahl unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen für die reellen und imaginären Teile in die entsprechende Zeichenfolgendarstellung in kartesischer Form.

ToString(String)

Konvertiert den Wert der aktuellen komplexen Zahl unter Verwendung des angegebenen Formats für die reellen und imaginären Teile in die entsprechende Zeichenfolgendarstellung in kartesischer Form.

ToString(IFormatProvider)

Konvertiert den Wert der aktuellen komplexen Zahl unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung in kartesischer Form.

ToString()

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

ToString(String, IFormatProvider)

Quelle:
Complex.cs
Quelle:
Complex.cs
Quelle:
Complex.cs

Konvertiert den Wert der aktuellen komplexen Zahl unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen für die reellen und imaginären Teile in die entsprechende Zeichenfolgendarstellung in kartesischer Form.

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 standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form entsprechend den Werten von format und provider.

Implementiert

Ausnahmen

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird ein Array mit komplexen Zahlen erstellt und jede 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)
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 komplexen Zahl, die von dieser Methode zurückgegeben wird, zeigt die Zahl mithilfe ihrer kartesischen Koordinaten in der Form (a b,) an, wobei a der reale Teil der komplexen Zahl und b der imaginäre Teil ist. Sowohl a als auch b werden mithilfe der von formatangegebenen Formatzeichenfolge formatiert. Der format Parameter kann ein beliebiger gültiger numerischer Standardformatbezeichner oder eine beliebige Kombination von benutzerdefinierten numerischen Formatbezeichnern sein. Wenn format gleich String.Empty oder ist null, 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 einen aus FormatException.

Die .NET Framework bietet umfangreiche Formatierungsunterstützung, die in den folgenden Themen ausführlicher beschrieben wird:

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

Der provider Parameter kann einer 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

Konvertiert den Wert der aktuellen komplexen Zahl unter Verwendung des angegebenen Formats für die reellen und imaginären Teile in die entsprechende Zeichenfolgendarstellung in kartesischer Form.

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 standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.

Gibt zurück

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form.

Ausnahmen

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird eine komplexe Zahl initialisiert und mit mehreren 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)
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

Die Zeichenfolgendarstellung der komplexen Zahl, die von dieser Methode zurückgegeben wird, zeigt die Zahl mithilfe ihrer kartesischen Koordinaten in der Form (a b,) an, wobei a der reale Teil der komplexen Zahl und b der imaginäre Teil ist. Sowohl a als auch b werden mithilfe der von formatangegebenen Formatzeichenfolge formatiert. Der format Parameter kann ein beliebiger gültiger numerischer Standardformatbezeichner oder eine beliebige Kombination von benutzerdefinierten numerischen Formatbezeichnern sein. Wenn format gleich String.Empty oder ist null, 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 einen aus FormatException.

Die .NET Framework bietet umfangreiche Formatierungsunterstützung, die in den folgenden Themen ausführlicher beschrieben wird:

Das Format der zurückgegebenen Zeichenfolge wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur bestimmt. Abhängig vom format Parameter steuert dieses Objekt Symbole wie das negative Vorzeichen, das Gruppentrennzeichen und das Dezimaltrennzeichen in der Ausgabezeichenfolge. Rufen Sie die Überladung auf, um Formatierungsinformationen für andere Kulturen als die ToString(String, IFormatProvider) aktuelle Kultur bereitzustellen.

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Quelle:
Complex.cs
Quelle:
Complex.cs
Quelle:
Complex.cs

Konvertiert den Wert der aktuellen komplexen Zahl unter Verwendung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung in kartesischer Form.

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

Die Zeichenfolgendarstellung der aktuellen Instanz in kartesischer Form entsprechend dem Wert von provider.

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)
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

Die Zeichenfolgendarstellung der komplexen Zahl, die von dieser Methode zurückgegeben wird, zeigt die Zahl mithilfe ihrer kartesischen Koordinaten in der Form (a b,) an, wobei a der reale Teil der komplexen Zahl und b der imaginäre Teil ist. Sowohl a als auch b werden mit dem allgemeinen Formatbezeichner ("G") und den Konventionen der durch providerdefinierten Kultur formatiert.

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

Der provider Parameter kann einer 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

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

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

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 Kultur Englisch – USA ("en-US"), bei der es sich in diesem Fall um die aktuelle Systemkultur handelt.

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)
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 ihrer kartesischen Koordinaten in der Form (a b,) an, wobei a der reale Teil der komplexen Zahl und b der imaginäre Teil ist. Sowohl a als auch b werden mit dem allgemeinen Formatbezeichner ("G") und den Konventionen der aktuellen Systemkultur formatiert.

Gilt für: