Complex.ToString Metoda

Reference

Definice

Obor názvů:: System.Numerics

Sestavení:: System.Runtime.Numerics.dll

Sestavení:: System.Numerics.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Převede hodnotu komplexního čísla na ekvivalentní řetězcové vyjádření.

Přetížení

ToString(String, IFormatProvider)	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi pro své skutečné a imaginární části.
ToString(String)	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu pro jeho skutečné a imaginární části.
ToString(IFormatProvider)	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaných informací o formátování specifické pro jazykovou verzi.
ToString()	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě.

ToString(String, IFormatProvider)

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi pro své skutečné a imaginární části.

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

Parametry

format: String

Standardní nebo vlastní řetězec číselného formátu.

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcové vyjádření aktuální instance v kartézské podobě, jak je určeno format a provider.

Implementuje

ToString(String, IFormatProvider)

Výjimky

FormatException

format není platný formátovací řetězec.

Příklady

Následující příklad vytvoří pole komplexních čísel a zobrazí každou z nich pomocí několika standardních formátových řetězců a také CultureInfo objektů, které představují jazykové verze pro angličtinu – Spojené státy ("en-US") a francouzštinu – Francii ("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)

Poznámky

Řetězcové znázornění komplexního čísla vrácené touto metodou zobrazuje číslo pomocí jeho kartézských souřadnic ve formuláři <a; b> (nebo (a, b) v .NET 7 a starších verzích), kde je skutečnou součástí komplexního čísla a b je jeho imaginární část. i b jsou formátovány pomocí formátovacího řetězce určeného format. Parametr format může být libovolný platný specifikátor standardního číselného formátu nebo libovolnou kombinaci specifikátorů vlastního číselného formátu. Je-li format roven String.Empty nebo je null, skutečné a imaginární části komplexního čísla jsou formátovány specifikátorem obecného formátu ("G"). Pokud format je jakákoli jiná hodnota, metoda vyvolá FormatException.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících článcích:

Další informace o číselných formátových řetězcích naleznete v tématu Standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o formátování v rozhraní .NET naleznete v tématu Typy formátování.

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace specifické pro jazykovou verzi o formátu skutečných a imaginárních čísel ve vráceném řetězci. V závislosti na parametru format tento objekt řídí symboly, jako je záporné znaménko, oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Pokud je providernull, vrácený řetězec je formátován pomocí NumberFormatInfo objektu aktuální jazykové verze.

Parametr provider může být jeden z následujících:

Objekt CultureInfo představující jazykovou verzi, která poskytuje informace o formátování
Objekt NumberFormatInfo, který poskytuje informace o formátování.
Vlastní objekt, který implementuje rozhraní IFormatProvider. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace o formátování.

Viz také

Platí pro

ToString(String)

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu pro jeho skutečné a imaginární části.

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

Parametry

format: String

Standardní nebo vlastní řetězec číselného formátu.

Návraty

String

Řetězcová reprezentace aktuální instance v kartézské podobě.

Výjimky

FormatException

format není platný formátovací řetězec.

Příklady

Následující příklad inicializuje komplexní číslo a zobrazí ho pomocí několika standardních formátových řetězců.

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)

Poznámky

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících článcích:

Další informace o číselných formátových řetězcích naleznete v tématu Standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o formátování v rozhraní .NET naleznete v tématu Typy formátování.

Formát vráceného řetězce je určen objektem NumberFormatInfo pro aktuální jazykovou verzi. V závislosti na parametru format tento objekt řídí symboly, jako je záporné znaménko, oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Chcete-li poskytnout informace o formátování pro jiné jazykové verze než aktuální jazyková verze, zavolejte ToString(String, IFormatProvider) přetížení.

Viz také

Platí pro

ToString(IFormatProvider)

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaných informací o formátování specifické pro jazykovou verzi.

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

Parametry

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcové vyjádření aktuální instance v kartézské podobě, jak je určeno provider.

Příklady

Následující příklad zobrazuje řetězcovou reprezentaci několika komplexních čísel. Výsledek používá konvence formátování anglické - Spojené státy ("en-US") a francouzštiny - Francie ("fr-FR") jazykové verze.

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)

Poznámky

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace specifické pro jazykovou verzi o formátu skutečných a imaginárních čísel ve vráceném řetězci. Pokud je providernull, vrácený řetězec je formátován pomocí NumberFormatInfo objektu aktuální jazykové verze.

Parametr provider může být jeden z následujících:

Objekt CultureInfo představující jazykovou verzi, která poskytuje informace o formátování
Objekt NumberFormatInfo, který poskytuje informace o formátování.
Vlastní objekt, který implementuje rozhraní IFormatProvider. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace o formátování.

Platí pro

ToString()

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Návraty

String

Řetězcová reprezentace aktuální instance v kartézské podobě.

Příklady

Následující příklad zobrazuje řetězcovou reprezentaci několika komplexních čísel. Výstup používá konvence formátování anglické - Spojené státy ("en-US") jazykové verze, což je v tomto případě aktuální systémová jazyková verze.

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)

Poznámky

Výchozí řetězcová reprezentace komplexního čísla zobrazuje číslo pomocí kartézských souřadnic ve formuláři <a; b> (nebo (a, b) v .NET 7 a starších verzích), kde je skutečnou součástí komplexního čísla a b je jeho imaginární částí. i b jsou formátované pomocí specifikátoru obecného formátu ("G") a konvencí aktuální jazykové verze systému.

Platí pro

Sdílet prostřednictvím

Complex.ToString Metoda

Definice

Přetížení

ToString(String, IFormatProvider)

Parametry

Návraty

Implementuje

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ToString(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ToString(IFormatProvider)

Parametry

Návraty

Příklady

Poznámky

Platí pro

ToString()

Návraty

Příklady

Poznámky

Platí pro

Další materiály