Complex.ToString Метод

Ссылка

Определение

Пространство имен:: System.Numerics

Сборка:: System.Runtime.Numerics.dll

Сборка:: System.Numerics.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует значение сложного числа в эквивалентное строковое представление.

Перегрузки

ToString(String, IFormatProvider)	Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовской форме с помощью указанного формата и сведений о формате, зависящее от языка и региональных параметров, для его реальных и мнимых частей.
ToString(String)	Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовской форме с помощью указанного формата для его реальных и мнимых частей.
ToString(IFormatProvider)	Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовой форме с помощью указанной информации о форматировании, зависящее от языка и региональных параметров.
ToString()	Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовой форме.

ToString(String, IFormatProvider)

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовской форме с помощью указанного формата и сведений о формате, зависящее от языка и региональных параметров, для его реальных и мнимых частей.

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

Параметры

format: String

Строка стандартного или настраиваемого числового формата.

provider: IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров.

Возвращаемое значение

String

Строковое представление текущего экземпляра в декартовой форме, как указано в format и provider.

Реализации

ToString(String, IFormatProvider)

Исключения

FormatException

format не является допустимой строкой формата.

Примеры

В следующем примере создается массив сложных чисел и отображается каждый из них с использованием нескольких стандартных строк форматирования, а также CultureInfo объектов, представляющих английский язык — Соединенные Штаты ("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") };
      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)

open System.Globalization
open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let cultures = [ CultureInfo "en-US"; CultureInfo "fr-FR" ]
let formats = [ "F2"; "N2"; "G5" ]

for c1 in c do
    for format in formats do
        for culture in cultures do
            printf $"{format} format string: {c1.ToString(format, culture)} ({culture.Name})    "

        printfn ""

    printfn ""
// 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)

Строковое представление сложного числа, возвращаемого этим методом, отображает число с помощью его декартовых координат в форме <a; b> (или (a, b) в .NET 7 и более ранних версиях), где является реальной частью сложного числа, а 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)

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовской форме с помощью указанного формата для его реальных и мнимых частей.

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

Параметры

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)

open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let formats = [ "F2"; "N2"; "G5" ]

for c1 in c do
    for format in formats do
        printf $"{format}: {c1.ToString(format)}    "

    printfn ""
// 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)

Дополнительные сведения о строках числовых форматов см. в строках стандартного числового формата и настраиваемых строк числовых форматов.
Дополнительные сведения о форматировании в .NET см. в типах форматирования.

Формат возвращаемой строки определяется объектом NumberFormatInfo для текущего языка и региональных параметров. В зависимости от параметра format этот объект управляет символами, такими как отрицательный знак, разделитель групп и символ десятичной запятой в выходной строке. Чтобы предоставить сведения о форматировании для языков и региональных параметров, отличных от текущего языка и региональных параметров, вызовите перегрузку ToString(String, IFormatProvider).

См. также раздел

строк стандартного числового формата
пользовательских строк числовых форматов

Применяется к

ToString(IFormatProvider)

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовой форме с помощью указанной информации о форматировании, зависящее от языка и региональных параметров.

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

Параметры

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)

open System.Globalization
open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let cultures = [ CultureInfo "en-US"; CultureInfo "fr-FR" ]

for c1 in c do
    for culture in cultures do
        printf $"{c1.ToString culture} ({culture.Name})"

    printfn ""
// 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)

Параметр provider — это реализация IFormatProvider. Его метод GetFormat возвращает объект NumberFormatInfo, предоставляющий сведения о формате реальных и мнимых чисел в возвращаемой строке. Если providernull, возвращаемая строка форматируется с помощью объекта NumberFormatInfo текущего языка и региональных параметров.

Параметр provider может быть одним из следующих:

Объект CultureInfo, представляющий язык и региональные параметры, предоставляющие сведения о форматировании
Объект NumberFormatInfo, предоставляющий сведения о форматировании.
Пользовательский объект, реализующий интерфейс IFormatProvider. Его метод GetFormat возвращает объект NumberFormatInfo, предоставляющий сведения о форматировании.

Применяется к

ToString()

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Исходный код:: Complex.cs

Преобразует значение текущего сложного числа в эквивалентное строковое представление в декартовой форме.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Возвращаемое значение

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)

open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

for c1 in c do
    printfn $"{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)

Строковое представление сложного числа по умолчанию отображает число с помощью его декартовых координат в форме <a; b> (или (a, b) в .NET 7 и более ранних версиях), где является реальной частью сложного числа, а b является его мнимой частью. Оба и b форматируются с использованием общего описатель формата ("G") и соглашений о текущем языке и региональных параметров системы.

Применяется к

Поделиться через

Complex.ToString Метод

Определение

Перегрузки

ToString(String, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToString(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

ToString(IFormatProvider)

Параметры

Возвращаемое значение

Примеры

Комментарии

Применяется к

ToString()

Возвращаемое значение

Примеры

Комментарии

Применяется к

Дополнительные ресурсы