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.

Konvertiert den Wert einer komplexen Zahl in die entsprechende Zeichenfolgendarstellung.

Überlädt

ToString()	Konvertiert den Wert der aktuellen komplexen Zahl 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(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(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()

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

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)

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 Standardmäßige Zeichenfolgendarstellung einer komplexen Zahl zeigt die Zahl mithilfe der kartesischen Koordinaten in form (a, b an, wobei a der reale Teil der komplexen Zahl ist und b) sein imaginärer Teil ist. Sowohl a als auch b werden mithilfe des allgemeinen Formatbezeichners ("G") und der Konventionen der aktuellen Systemkultur formatiert.

Gilt für:

ToString(IFormatProvider)

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

String

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 Englisch - USA ("en-US") und Französisch - Frankreich ("fr-FR") Kulturen.

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

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. nullIst provider die zurückgegebene Zeichenfolge mit dem NumberFormatInfo Objekt 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 Objekt zurück, das NumberFormatInfo Formatierungsinformationen bereitstellt.

Gilt für:

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.

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

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)

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 der Kartesiankoordinaten in form (a, b an, wobei a der reale Teil der komplexen Zahl ist und b) sein imaginärer Teil ist. Sowohl a als auch b werden mithilfe der formatzeichenfolge formatiert, die durch format. Der format Parameter kann ein beliebiger gültiger numerischer Standardformatbezeichner oder eine beliebige Kombination von benutzerdefinierten numerischen Formatbezeichnern sein. String.Empty Wenn format gleich oder istnull, werden die realen und imaginären Teile der komplexen Zahl mit dem allgemeinen Formatbezeichner ("G") formatiert. Wenn format ein anderer Wert vorhanden ist, löst die Methode eine FormatException.

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

Weitere Informationen zu numerischen Formatzeichenfolgen finden Sie unter Standard-Numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung im .NET Framework finden Sie unter Formatierungstypen.

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

Siehe auch

Gilt für:

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.

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

String

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

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird ein Array von komplexen Zahlen erstellt, und es werden jeweils mehrere Standardformatzeichenfolgen sowie CultureInfo Objekte 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 .NET Framework bietet umfassende Formatierungsunterstützung, die in den folgenden Themen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatzeichenfolgen finden Sie unter Standard-Numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung im .NET Framework 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. format Je nach Parameter steuert dieses Objekt Symbole wie das negative Zeichen, das Gruppentrennzeichen und das Dezimalzeichen in der Ausgabezeichenfolge. nullIst provider die zurückgegebene Zeichenfolge mit dem NumberFormatInfo Objekt 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 Objekt zurück, das NumberFormatInfo Formatierungsinformationen bereitstellt.

Siehe auch

Gilt für: