Complex.ToString Metoda

Definicja

Konwertuje wartość liczby zespolonej na jej równoważną reprezentację w postaci ciągu.Converts the value of a complex number to its equivalent string representation.

Przeciążenia

ToString()

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w formie kartezjańskiego.Converts the value of the current complex number to its equivalent string representation in Cartesian form.

ToString(IFormatProvider)

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w postaci kartezjańskiego przy użyciu określonych informacji o formatowaniu specyficznych dla kultury.Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified culture-specific formatting information.

ToString(String)

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w postaci kartezjańskiego przy użyciu określonego formatu dla jego części rzeczywistych i urojonych.Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format for its real and imaginary parts.

ToString(String, IFormatProvider)

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w postaci kartezjańskiego przy użyciu określonego formatu i informacji o formacie specyficznym dla kultury dla jego części rzeczywistych i urojonych.Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format and culture-specific format information for its real and imaginary parts.

ToString()

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w formie kartezjańskiego.Converts the value of the current complex number to its equivalent string representation in Cartesian form.

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

Zwraca

Ciąg reprezentujący bieżące wystąpienie w formularzu kartezjańskiego.The string representation of the current instance in Cartesian form.

Przykłady

Poniższy przykład Wyświetla reprezentację ciągu kilku liczb zespolonych.The following example displays the string representation of several complex numbers. Dane wyjściowe używają Konwencji formatowania kultury angielskiej Stany Zjednoczone ("en-US"), która w tym przypadku jest bieżącą kulturą systemu.The output uses the formatting conventions of the English - United States ("en-US") culture, which, in this case, is the current system culture.

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)

Uwagi

Domyślna reprezentacja (liczby zespolonej wyświetla liczbę przy użyciu jej współrzędnych kartezjańskiego w formie a , b), gdzie a jest rzeczywistą częścią liczby zespolonej, a b jest jej części urojonej.The default string representation of a complex number displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Zarówno ** a, jak i b są formatowane przy użyciu specyfikatora formatu ogólnego ("G") i Konwencji bieżącej kultury systemowej.Both a and b are formatted using the general format specifier ("G") and the conventions of the current system culture.

ToString(IFormatProvider)

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w postaci kartezjańskiego przy użyciu określonych informacji o formatowaniu specyficznych dla kultury.Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified culture-specific formatting information.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

Ciąg reprezentujący bieżące wystąpienie w formularzu kartezjańskiego, określony przez provider.The string representation of the current instance in Cartesian form, as specified by provider.

Przykłady

Poniższy przykład Wyświetla reprezentację ciągu kilku liczb zespolonych.The following example displays the string representation of several complex numbers. W wyniku są stosowane konwencje formatowania angielskiej Stany Zjednoczone ("en-US") i francuski — Francja ("fr-FR").The result uses the formatting conventions of the English - United States ("en-US") and French - France ("fr-FR") cultures.

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)

Uwagi

Ciąg reprezentujący liczbę zespoloną zwracaną przez tę metodę wyświetla liczbę przy użyciu jej współrzędnych kartezjańskiego w (formie a , b), gdzie a jest rzeczywistą częścią liczby zespolonej, i b jest jej częścią urojoną.The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Zarówno ** a, jak i b są formatowane przy użyciu specyfikatora formatu ogólnego ("G") oraz Konwencji kultury zdefiniowanej providerprzez.Both a and b are formatted using the general format specifier ("G") and the conventions of the culture defined by provider.

provider ParametrIFormatProvider jest implementacją.The provider parameter is an IFormatProvider implementation. Jego GetFormat MetodaNumberFormatInfo zwraca obiekt, który dostarcza specyficzne dla kultury informacje o formacie liczb rzeczywistych i urojonych w zwracanym ciągu.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the real and imaginary numbers in the returned string. Jeśli provider jest null, zwracanyNumberFormatInfo ciąg jest formatowany przy użyciu obiektu bieżącej kultury.If provider is null, the returned string is formatted using the NumberFormatInfo object of the current culture.

provider Parametr może mieć jedną z następujących wartości:The provider parameter can be one of the following:

ToString(String)

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w postaci kartezjańskiego przy użyciu określonego formatu dla jego części rzeczywistych i urojonych.Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format for its real and imaginary parts.

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

Parametry

format
String

Standardowy lub niestandardowy ciąg formatu liczbowego.A standard or custom numeric format string.

Zwraca

Ciąg reprezentujący bieżące wystąpienie w formularzu kartezjańskiego.The string representation of the current instance in Cartesian form.

Wyjątki

formatnie jest prawidłowym ciągiem formatu.format is not a valid format string.

Przykłady

Poniższy przykład inicjuje liczbę zespoloną i wyświetla ją przy użyciu kilku ciągów formatu standardowego.The following example initializes a complex number and displays it using several standard format strings.

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)

Uwagi

Ciąg reprezentujący liczbę zespoloną zwracaną przez tę metodę wyświetla liczbę przy użyciu jej współrzędnych kartezjańskiego w (formie a , b), gdzie a jest rzeczywistą częścią liczby zespolonej, i b jest jej częścią urojoną.The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Zarówno ** a, jak i b są formatowane przy użyciu ciągu formatformatu określonego przez.Both a and b are formatted using the format string specified by format. format Parametr może być dowolnym prawidłowym specyfikatorem standardowego formatu liczbowego lub dowolną kombinacją niestandardowych specyfikatorów formatu liczbowego.The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. Jeśli format jest nullrówne lub is, rzeczywiste i urojone części liczby zespolonej są formatowane przy użyciu specyfikatora formatu ogólnego ("G"). String.EmptyIf format is equal to String.Empty or is null, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). Jeśli format jest dowolną inną wartością, Metoda FormatExceptionzgłasza.If format is any other value, the method throws a FormatException.

.NET Framework zapewnia rozbudowaną obsługę formatowania, co opisano szczegółowo w następujących tematach:The .NET Framework provides extensive formatting support, which is described in greater detail in the following topics:

Format zwracanego ciągu jest określany przez NumberFormatInfo obiekt dla bieżącej kultury.The format of the returned string is determined by the NumberFormatInfo object for the current culture. W zależności format od parametru ten obiekt kontroluje symbole, takie jak znak minus, separator grupy i symbol separatora dziesiętnego w ciągu danych wyjściowych.Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. Aby zapewnić informacje o formatowaniu dla kultur innych niż bieżąca kultura, wywołaj ToString(String, IFormatProvider) Przeciążenie.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Zobacz też

ToString(String, IFormatProvider)

Konwertuje wartość bieżącej liczby zespolonej na jej równoważną reprezentację w postaci ciągu w postaci kartezjańskiego przy użyciu określonego formatu i informacji o formacie specyficznym dla kultury dla jego części rzeczywistych i urojonych.Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format and culture-specific format information for its real and imaginary parts.

public:
 virtual System::String ^ ToString(System::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

Parametry

format
String

Standardowy lub niestandardowy ciąg formatu liczbowego.A standard or custom numeric format string.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

Ciąg reprezentujący bieżące wystąpienie w formularzu kartezjańskiego, zgodnie format z parametrami i. providerThe string representation of the current instance in Cartesian form, as specified by format and provider.

Implementuje

Wyjątki

formatnie jest prawidłowym ciągiem formatu.format is not a valid format string.

Przykłady

Poniższy przykład tworzy tablicę liczb zespolonych i wyświetla każdą z nich przy użyciu kilku ciągów CultureInfo formatu standardowego oraz obiektów, które reprezentują kultury Stany Zjednoczone w języku angielskim ("en-us") i francuski — Francja ("fr-fr").The following example creates an array of complex numbers, and displays each using several standard format strings as well as CultureInfo objects that represent the English - United States ("en-US") and French - France ("fr-FR") cultures.

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)

Uwagi

Ciąg reprezentujący liczbę zespoloną zwracaną przez tę metodę wyświetla liczbę przy użyciu jej współrzędnych kartezjańskiego w (formie a , b), gdzie a jest rzeczywistą częścią liczby zespolonej, i b jest jej częścią urojoną.The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Zarówno ** a, jak i b są formatowane przy użyciu ciągu formatformatu określonego przez.Both a and b are formatted using the format string specified by format. format Parametr może być dowolnym prawidłowym specyfikatorem standardowego formatu liczbowego lub dowolną kombinacją niestandardowych specyfikatorów formatu liczbowego.The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. Jeśli format jest nullrówne lub is, rzeczywiste i urojone części liczby zespolonej są formatowane przy użyciu specyfikatora formatu ogólnego ("G"). String.EmptyIf format is equal to String.Empty or is null, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). Jeśli format jest dowolną inną wartością, Metoda FormatExceptionzgłasza.If format is any other value, the method throws a FormatException.

.NET Framework zapewnia rozbudowaną obsługę formatowania, co opisano szczegółowo w następujących tematach:The .NET Framework provides extensive formatting support, which is described in greater detail in the following topics:

provider ParametrIFormatProvider jest implementacją.The provider parameter is an IFormatProvider implementation. Jego GetFormat MetodaNumberFormatInfo zwraca obiekt, który dostarcza specyficzne dla kultury informacje o formacie liczb rzeczywistych i urojonych w zwracanym ciągu.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the real and imaginary numbers in the returned string. W zależności format od parametru ten obiekt kontroluje symbole, takie jak znak minus, separator grupy i symbol separatora dziesiętnego w ciągu danych wyjściowych.Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. Jeśli provider jest null, zwracanyNumberFormatInfo ciąg jest formatowany przy użyciu obiektu bieżącej kultury.If provider is null, the returned string is formatted using the NumberFormatInfo object of the current culture.

provider Parametr może mieć jedną z następujących wartości:The provider parameter can be one of the following:

Zobacz też

Dotyczy