Complex.ToString 方法

定义

命名空间:

System.Numerics

程序集:

System.Runtime.Numerics.dll

将复数的值转换为其等效的字符串表示形式。

重载

ToString(String, IFormatProvider)	使用指定格式和区域性特定的格式信息，将当前复数的值转换为其以笛卡尔形式表示的等效字符串表示形式，以实际部分和虚构部分。
ToString(String)	将当前复数的值转换为其以笛卡尔形式表示的等效字符串表示形式，方法是使用指定格式作为其真实和虚部。
ToString(IFormatProvider)	使用指定的区域性特定的格式设置信息，将当前复数的值转换为其以笛卡尔形式表示的等效字符串表示形式。
ToString()	将当前复数的值转换为其等效的字符串表示形式（以笛卡尔形式）。

ToString(String, IFormatProvider)

Source:

Complex.cs

使用指定格式和区域性特定的格式信息，将当前复数的值转换为其以笛卡尔形式表示的等效字符串表示形式，以实际部分和虚构部分。

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

参数

format

String

标准或自定义数字格式字符串。

provider

IFormatProvider

提供区域性特定的格式设置信息的对象。

返回

String

由 format 和 provider指定的笛卡尔形式的当前实例的字符串表示形式。

实现

ToString(String, IFormatProvider)

例外

FormatException

format 不是有效的格式字符串。

示例

以下示例创建一个复数数组，并使用多个标准格式字符串以及表示英语-美国（“en-US”）和法国（“fr-FR”）区域性的 CultureInfo 对象显示每个数字。

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)

注解

此方法返回的复数的字符串表示形式使用其笛卡尔 <a; b> 坐标（或 .NET 7 和早期版本中的 (a, b)）显示数字，其中 是复数的真实部分，b 是其虚构部分。 和 b 均使用 format指定的格式字符串进行格式化。 format 参数可以是任何有效的标准数字格式说明符，也可以是自定义数字格式说明符的任意组合。 如果 format 等于 String.Empty 或 null，则复数的实数和虚部使用常规格式说明符（“G”）进行格式设置。 如果 format 是任何其他值，该方法将引发 FormatException。

.NET 提供广泛的格式支持，本文更详细地介绍了这些支持：

• 有关数值格式字符串的详细信息，请参阅 标准数字格式字符串 和 自定义数字格式字符串。
• 有关 .NET 中的格式设置的详细信息，请参阅 格式设置类型。

provider 参数是 IFormatProvider 实现。 其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关返回字符串中真实数字和虚数格式的区域性特定信息。 根据 format 参数，此对象控制负号、组分隔符和输出字符串中的小数点符号等符号。 如果 providernull，则返回的字符串使用当前区域性的 NumberFormatInfo 对象进行格式化。

provider 参数可以是下列参数之一：

• 表示提供格式设置信息的区域性的 CultureInfo 对象
• 提供格式信息的 NumberFormatInfo 对象。
• 实现 IFormatProvider 接口的自定义对象。 其 GetFormat 方法返回提供格式信息的 NumberFormatInfo 对象。

另请参阅

• 标准数字格式字符串
• 自定义数字格式字符串

ToString(String)

Source:

Complex.cs

将当前复数的值转换为其以笛卡尔形式表示的等效字符串表示形式，方法是使用指定格式作为其真实和虚部。

public string ToString (string? format);

参数

format

String

标准或自定义数字格式字符串。

返回

String

以笛卡尔形式表示当前实例的字符串表示形式。

例外

FormatException

format 不是有效的格式字符串。

示例

以下示例初始化复数，并使用多个标准格式字符串显示它。

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)

注解

此方法返回的复数的字符串表示形式使用其笛卡尔 <a; b> 坐标（或 .NET 7 和早期版本中的 (a, b)）显示数字，其中 是复数的真实部分，b 是其虚构部分。 和 b 均使用 format指定的格式字符串进行格式化。 format 参数可以是任何有效的标准数字格式说明符，也可以是自定义数字格式说明符的任意组合。 如果 format 等于 String.Empty 或 null，则复数的实数和虚部使用常规格式说明符（“G”）进行格式设置。 如果 format 是任何其他值，该方法将引发 FormatException。

.NET 提供广泛的格式支持，本文更详细地介绍了这些支持：

• 有关数值格式字符串的详细信息，请参阅 标准数字格式字符串 和 自定义数字格式字符串。
• 有关 .NET 中的格式设置的详细信息，请参阅 格式设置类型。

返回的字符串的格式由当前区域性的 NumberFormatInfo 对象确定。 根据 format 参数，此对象控制负号、组分隔符和输出字符串中的小数点符号等符号。 若要为当前区域性以外的区域性提供格式设置信息，请调用 ToString(String, IFormatProvider) 重载。

另请参阅

• 标准数字格式字符串
• 自定义数字格式字符串

ToString(IFormatProvider)

Source:

Complex.cs

使用指定的区域性特定的格式设置信息，将当前复数的值转换为其以笛卡尔形式表示的等效字符串表示形式。

public string ToString (IFormatProvider? provider);

参数

provider

IFormatProvider

提供区域性特定的格式设置信息的对象。

返回

String

由 provider指定的以笛卡尔形式表示的当前实例的字符串表示形式。

示例

以下示例显示多个复数的字符串表示形式。 结果使用英语-美国（“en-US”）和法语-法国（“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)

注解

此方法返回的复数的字符串表示形式使用其笛卡尔 <a; b> 坐标（或 .NET 7 和早期版本中的 (a, b)）显示数字，其中 是复数的真实部分，b 是其虚构部分。 和 b 均使用常规格式说明符（“G”）和 provider定义的区域性约定进行格式化。

provider 参数是 IFormatProvider 实现。 其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关返回字符串中真实数字和虚数格式的区域性特定信息。 如果 providernull，则返回的字符串使用当前区域性的 NumberFormatInfo 对象进行格式化。

provider 参数可以是下列参数之一：

• 表示提供格式设置信息的区域性的 CultureInfo 对象
• 提供格式信息的 NumberFormatInfo 对象。
• 实现 IFormatProvider 接口的自定义对象。 其 GetFormat 方法返回提供格式信息的 NumberFormatInfo 对象。

ToString()

Source:

Complex.cs

将当前复数的值转换为其等效的字符串表示形式（以笛卡尔形式）。

public override string ToString ();

返回

String

以笛卡尔形式表示当前实例的字符串表示形式。

示例

以下示例显示多个复数的字符串表示形式。 输出使用英语 - 美国（“en-US”）区域性的格式设置约定，在本例中为当前系统区域性。

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)

注解

复数的默认字符串表示形式使用其笛卡尔 <a; b> 坐标（或 .NET 7 及早期版本中的 (a, b)）显示数字，其中 是复数的实际部分，b 是其虚构部分。 和 b 均使用常规格式说明符（“G”）和当前系统区域性的约定进行格式化。