Complex.ToString 方法

定义

将复数的值转换为其等效的字符串表示形式。Converts the value of a complex number to its equivalent string representation.

重载

ToString()

将当前复数的值转换为其采用笛卡尔形式的等效字符串表示形式。Converts the value of the current complex number to its equivalent string representation in Cartesian form.

ToString(IFormatProvider)

使用指定的区域性特定格式设置信息,将当前复数的值转换为其采用笛卡尔形式的等效字符串表示形式。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)

通过对当前复数的实部和虚部使用指定格式,将它的值转换为其采用笛卡尔形式的等效字符串表示形式。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)

通过对当前复数的实部和虚部使用指定格式和区域性特定格式信息,将它的值转换为其采用笛卡尔形式的等效字符串表示形式。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()

将当前复数的值转换为其采用笛卡尔形式的等效字符串表示形式。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

返回

当前实例的采用笛卡尔形式的字符串表示形式。The string representation of the current instance in Cartesian form.

示例

下面的示例显示了若干复数的字符串表示形式。The following example displays the string representation of several complex numbers. 输出使用英语美国("en-us")区域性的格式约定,在此示例中,为当前系统区域性。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)

注解

复数的默认字符串表示形式使用其笛卡尔坐标 (``, b)形式显示数字,其中a是复数的实部, b是其虚部。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. b 均使用常规格式说明符("G")和当前系统区域性的约定进行格式化。Both a and b are formatted using the general format specifier ("G") and the conventions of the current system culture.

ToString(IFormatProvider)

使用指定的区域性特定格式设置信息,将当前复数的值转换为其采用笛卡尔形式的等效字符串表示形式。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

参数

provider
IFormatProvider

一个提供区域性特定的格式设置信息的对象。An object that supplies culture-specific formatting information.

返回

provider 指定的当前实例的采用笛卡尔形式的字符串表示形式。The string representation of the current instance in Cartesian form, as specified by provider.

示例

下面的示例显示了若干复数的字符串表示形式。The following example displays the string representation of several complex numbers. 该结果使用英语美国("en-us")和法语-法国("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)

注解

此方法返回的复数的字符串表示形式使用其笛卡尔坐标 (``, b),其中a是复数的实部,而b是其虚部。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. b 均使用常规格式说明符("G")和由 provider定义的区域性约定进行格式化。Both a and b are formatted using the general format specifier ("G") and the conventions of the culture defined by provider.

provider 参数是一个 IFormatProvider 实现。The provider parameter is an IFormatProvider implementation. 它的 GetFormat 方法返回一个 NumberFormatInfo 对象,该对象提供有关返回的字符串中的实数和虚数格式的区域性特定信息。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. 如果 null``provider,则使用当前区域性的 NumberFormatInfo 对象设置返回的字符串的格式。If provider is null, the returned string is formatted using the NumberFormatInfo object of the current culture.

provider 参数可以是以下项之一:The provider parameter can be one of the following:

ToString(String)

通过对当前复数的实部和虚部使用指定格式,将它的值转换为其采用笛卡尔形式的等效字符串表示形式。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

参数

format
String

标准或自定义的数值格式字符串。A standard or custom numeric format string.

返回

当前实例的采用笛卡尔形式的字符串表示形式。The string representation of the current instance in Cartesian form.

异常

format 不是有效的格式字符串。format is not a valid format string.

示例

下面的示例初始化复数,并使用多个标准格式字符串显示它。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)

注解

此方法返回的复数的字符串表示形式使用其笛卡尔坐标 (``, b),其中a是复数的实部,而b是其虚部。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. 使用 format指定的格式字符串设置和**的格式。Both a and b are formatted using the format string specified by format. format 参数可以是任何有效的标准数值格式说明符,也可以是自定义数字格式说明符的任意组合。The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. 如果 format 等于 String.Emptynull,则复数的实部和虚部用常规格式说明符("G")进行格式设置。If 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"). 如果 format 为任何其他值,则该方法将引发 FormatExceptionIf format is any other value, the method throws a FormatException.

.NET Framework 提供丰富的格式设置支持,请参阅以下主题中的更详细说明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following topics:

返回的字符串的格式由当前区域性的 NumberFormatInfo 对象确定。The format of the returned string is determined by the NumberFormatInfo object for the current culture. 根据 format 参数,此对象控制输出字符串中的符号,如负号、组分隔符和小数点符号。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. 若要为当前区域性以外的区域性提供格式设置信息,请调用 ToString(String, IFormatProvider) 重载。To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

另请参阅

ToString(String, IFormatProvider)

通过对当前复数的实部和虚部使用指定格式和区域性特定格式信息,将它的值转换为其采用笛卡尔形式的等效字符串表示形式。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

参数

format
String

标准或自定义的数值格式字符串。A standard or custom numeric format string.

provider
IFormatProvider

一个提供区域性特定的格式设置信息的对象。An object that supplies culture-specific formatting information.

返回

formatprovider 指定的当前实例的采用笛卡尔形式的字符串表示形式。The string representation of the current instance in Cartesian form, as specified by format and provider.

实现

异常

format 不是有效的格式字符串。format is not a valid format string.

示例

下面的示例创建一个复数数组,并使用多个标准格式字符串以及表示英语-美国("en-us")和法语-法国("fr-fr")区域性的 CultureInfo 对象显示每个数字。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)

注解

此方法返回的复数的字符串表示形式使用其笛卡尔坐标 (``, b),其中a是复数的实部,而b是其虚部。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. 使用 format指定的格式字符串设置和**的格式。Both a and b are formatted using the format string specified by format. format 参数可以是任何有效的标准数值格式说明符,也可以是自定义数字格式说明符的任意组合。The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. 如果 format 等于 String.Emptynull,则复数的实部和虚部用常规格式说明符("G")进行格式设置。If 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"). 如果 format 为任何其他值,则该方法将引发 FormatExceptionIf format is any other value, the method throws a FormatException.

.NET Framework 提供丰富的格式设置支持,请参阅以下主题中的更详细说明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following topics:

provider 参数是一个 IFormatProvider 实现。The provider parameter is an IFormatProvider implementation. 它的 GetFormat 方法返回一个 NumberFormatInfo 对象,该对象提供有关返回的字符串中的实数和虚数格式的区域性特定信息。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. 根据 format 参数,此对象控制输出字符串中的符号,如负号、组分隔符和小数点符号。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. 如果 null``provider,则使用当前区域性的 NumberFormatInfo 对象设置返回的字符串的格式。If provider is null, the returned string is formatted using the NumberFormatInfo object of the current culture.

provider 参数可以是以下项之一:The provider parameter can be one of the following:

另请参阅

适用于