Complex.ToString Método

Definición

Espacio de nombres:

System.Numerics

Ensamblado:

System.Runtime.Numerics.dll

Convierte el valor de un número complejo en su representación de cadena equivalente.

Sobrecargas

ToString(String, IFormatProvider)	Convierte el valor del número complejo actual en su representación de cadena equivalente en forma cartesiana mediante el formato especificado y la información de formato específica de la referencia cultural para sus partes reales e imaginarias.
ToString(String)	Convierte el valor del número complejo actual en su representación de cadena equivalente en forma cartesiana utilizando el formato especificado para sus partes reales e imaginarias.
ToString(IFormatProvider)	Convierte el valor del número complejo actual en su representación de cadena equivalente en formato cartesiano mediante la información de formato específica de la referencia cultural especificada.
ToString()	Convierte el valor del número complejo actual en su representación de cadena equivalente en forma cartesiana.

ToString(String, IFormatProvider)

Source:

Complex.cs

Convierte el valor del número complejo actual en su representación de cadena equivalente en forma cartesiana mediante el formato especificado y la información de formato específica de la referencia cultural para sus partes reales e imaginarias.

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

Parámetros

format

String

Cadena de formato numérico estándar o personalizado.

provider

IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

String

Representación de cadena de la instancia actual en forma cartesiana, tal como se especifica en format y provider.

Implementaciones

ToString(String, IFormatProvider)

Excepciones

FormatException

format no es una cadena de formato válida.

Ejemplos

En el ejemplo siguiente se crea una matriz de números complejos y se muestran cada una con varias cadenas de formato estándar, así como CultureInfo objetos que representan las referencias culturales Inglés - Estados Unidos ("en-US") y Francés - Francia ("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)

Comentarios

La representación de cadena del número complejo devuelto por este método muestra el número utilizando sus coordenadas cartesianas en forma <a; b> (o (a, b) en .NET 7 y versiones anteriores), donde una es la parte real del número complejo y b es su parte imaginaria. Tanto un como b tienen formato mediante la cadena de formato especificada por format. El parámetro format puede ser cualquier especificador de formato numérico estándar válido o cualquier combinación de especificadores de formato numérico personalizado. Si format es igual a String.Empty o es null, las partes reales e imaginarias del número complejo tienen formato con el especificador de formato general ("G"). Si format es cualquier otro valor, el método produce un FormatException.

.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los artículos siguientes:

• Para obtener más información sobre las cadenas de formato numérico, vea cadenas de formato numérico estándar y cadenas de formato numérico personalizado.
• Para obtener más información sobre el formato en .NET, consulte Tipos de formato.

El parámetro provider es una implementación de IFormatProvider. Su método GetFormat devuelve un objeto NumberFormatInfo que proporciona información específica de la referencia cultural sobre el formato de los números reales e imaginarios de la cadena devuelta. Dependiendo del parámetro format, este objeto controla símbolos como el signo negativo, el separador de grupo y el símbolo de separador decimal de la cadena de salida. Si provider es null, la cadena devuelta se da formato mediante el objeto NumberFormatInfo de la referencia cultural actual.

El parámetro provider puede ser uno de los siguientes:

• Objeto CultureInfo que representa la referencia cultural que proporciona información de formato
• Objeto NumberFormatInfo que proporciona información de formato.
• Objeto personalizado que implementa la interfaz IFormatProvider. Su método GetFormat devuelve el objeto NumberFormatInfo que proporciona información de formato.

Consulte también

• cadenas de formato numérico estándar
• cadenas de formato numérico personalizado

ToString(String)

Source:

Complex.cs

Convierte el valor del número complejo actual en su representación de cadena equivalente en forma cartesiana utilizando el formato especificado para sus partes reales e imaginarias.

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

Parámetros

format

String

Cadena de formato numérico estándar o personalizado.

Devoluciones

String

Representación de cadena de la instancia actual en forma cartesiana.

Excepciones

FormatException

format no es una cadena de formato válida.

Ejemplos

En el ejemplo siguiente se inicializa un número complejo y se muestra mediante varias cadenas de formato estándar.

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)

Comentarios

La representación de cadena del número complejo devuelto por este método muestra el número utilizando sus coordenadas cartesianas en forma <a; b> (o (a, b) en .NET 7 y versiones anteriores), donde una es la parte real del número complejo y b es su parte imaginaria. Tanto un como b tienen formato mediante la cadena de formato especificada por format. El parámetro format puede ser cualquier especificador de formato numérico estándar válido o cualquier combinación de especificadores de formato numérico personalizado. Si format es igual a String.Empty o es null, las partes reales e imaginarias del número complejo tienen formato con el especificador de formato general ("G"). Si format es cualquier otro valor, el método produce un FormatException.

.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los artículos siguientes:

• Para obtener más información sobre las cadenas de formato numérico, vea cadenas de formato numérico estándar y cadenas de formato numérico personalizado.
• Para obtener más información sobre el formato en .NET, consulte Tipos de formato.

El formato de la cadena devuelta viene determinado por el objeto NumberFormatInfo para la referencia cultural actual. Dependiendo del parámetro format, este objeto controla símbolos como el signo negativo, el separador de grupo y el símbolo de separador decimal de la cadena de salida. Para proporcionar información de formato para referencias culturales distintas de la referencia cultural actual, llame a la sobrecarga de ToString(String, IFormatProvider).

Consulte también

• cadenas de formato numérico estándar
• cadenas de formato numérico personalizado

ToString(IFormatProvider)

Source:

Complex.cs

Convierte el valor del número complejo actual en su representación de cadena equivalente en formato cartesiano mediante la información de formato específica de la referencia cultural especificada.

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parámetros

provider

IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

String

Representación de cadena de la instancia actual en forma cartesiana, tal como se especifica en provider.

Ejemplos

En el ejemplo siguiente se muestra la representación de cadena de varios números complejos. El resultado usa las convenciones de formato de las referencias culturales Inglés - Estados Unidos ("en-US") y Francés - Francia ("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)

Comentarios

La representación de cadena del número complejo devuelto por este método muestra el número utilizando sus coordenadas cartesianas en forma <a; b> (o (a, b) en .NET 7 y versiones anteriores), donde una es la parte real del número complejo y b es su parte imaginaria. Tanto un como b tienen formato mediante el especificador de formato general ("G") y las convenciones de la referencia cultural definida por provider.

El parámetro provider es una implementación de IFormatProvider. Su método GetFormat devuelve un objeto NumberFormatInfo que proporciona información específica de la referencia cultural sobre el formato de los números reales e imaginarios de la cadena devuelta. Si provider es null, la cadena devuelta se da formato mediante el objeto NumberFormatInfo de la referencia cultural actual.

El parámetro provider puede ser uno de los siguientes:

• Objeto CultureInfo que representa la referencia cultural que proporciona información de formato
• Objeto NumberFormatInfo que proporciona información de formato.
• Objeto personalizado que implementa la interfaz IFormatProvider. Su método GetFormat devuelve el objeto NumberFormatInfo que proporciona información de formato.

ToString()

Source:

Complex.cs

Convierte el valor del número complejo actual en su representación de cadena equivalente en forma cartesiana.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Devoluciones

String

Representación de cadena de la instancia actual en forma cartesiana.

Ejemplos

En el ejemplo siguiente se muestra la representación de cadena de varios números complejos. La salida usa las convenciones de formato de la referencia cultural Inglés - Estados Unidos ("en-US") , que, en este caso, es la referencia cultural del sistema actual.

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)

Comentarios

La representación de cadena predeterminada de un número complejo muestra el número mediante sus coordenadas cartesianas en forma <a; b> (o (a, b) en .NET 7 y versiones anteriores), donde una es la parte real del número complejo y b es su parte imaginaria. Tanto un como b tienen formato mediante el especificador de formato general ("G") y las convenciones de la referencia cultural del sistema actual.