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)

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 — его мнимая часть. И a , и b форматируются с помощью строки форматирования, заданной параметром format. Параметром format может быть любой допустимый описатель стандартного числового формата или любое сочетание описателей настраиваемых числовых форматов. Если format равно String.Empty или равно null, реальная и мнимая части комплексного числа форматируются с помощью описателя общего формата ("G"). Если format является любым другим значением, метод создает исключение FormatException.

В платформа .NET Framework реализована расширенная поддержка форматирования, которая более подробно описана в следующих разделах:

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

Параметр provider является реализацией IFormatProvider . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате реальных и мнимых чисел в возвращаемой строке с учетом языка и региональных параметров. В зависимости format от параметра этот объект управляет такими символами, как отрицательный знак, разделитель групп и символ десятичной запятой в выходной строке. Если provider имеет значение null, возвращаемая строка форматируется с использованием 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)

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 Framework см. в разделе Типы форматирования.

Формат возвращаемой строки определяется 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)

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 объект , предоставляющий сведения о формате реальных и мнимых чисел в возвращаемой строке с учетом языка и региональных параметров. Если provider имеет значение null, возвращаемая строка форматируется с использованием 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)

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 — его мнимая часть. И a , и b форматируются с помощью общего описатель формата ("G") и соглашений текущего системного языка и региональных параметров.

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

Complex.ToString Метод

Определение

Перегрузки

ToString(String, IFormatProvider)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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

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

ToString(String)

Параметры

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

Исключения

Примеры

Комментарии

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

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

ToString(IFormatProvider)

Параметры

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

Примеры

Комментарии

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

ToString()

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

Примеры

Комментарии

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

Обратная связь

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