Complex.ToString Método

Referencia

Definición

Espacio de nombres:: System.Numerics

Ensamblado:: System.Runtime.Numerics.dll

Ensamblado:: System.Numerics.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Sobrecargas

ToString(String, IFormatProvider)	Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano utilizando el formato especificado y la información de formato específica de la referencia cultural indicada para la parte real y la parte imaginaria.
ToString(String)	Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano utilizando el formato especificado para la parte real y la parte imaginaria.
ToString(IFormatProvider)	Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano utilizando la información de formato específica de la referencia cultural indicada.
ToString()	Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano.

ToString(String, IFormatProvider)

Source:: Complex.cs

Source:: Complex.cs

Source:: Complex.cs

Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano utilizando el formato especificado y la información de formato específica de la referencia cultural indicada para la parte real y la parte imaginaria.

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

Parámetros

format: String

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

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 formato cartesiano, tal como especifican format y provider.

Implementaciones

ToString(String, IFormatProvider)

Excepciones

FormatException

format no es una cadena de formato válido.

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)

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 la forma (b),, donde es la parte real del número complejo y b es su parte imaginaria. Tanto a como b se les da formato mediante la cadena de formato especificada por format. El format parámetro 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 una FormatExceptionexcepción .

.NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas 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 Framework, vea Aplicar formato a tipos.

El provider parámetro es una IFormatProvider implementación. Su GetFormat método devuelve un NumberFormatInfo objeto 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 format parámetro , este objeto controla símbolos como el signo negativo, el separador de grupo y el símbolo de separador decimal en la cadena de salida. Si provider es null, la cadena devuelta tiene el formato utilizando el NumberFormatInfo objeto de la referencia cultural actual.

El provider parámetro 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 IFormatProvider interfaz . Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato.

Consulte también

Se aplica a

ToString(String)

Source:: Complex.cs

Source:: Complex.cs

Source:: Complex.cs

Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano utilizando el formato especificado para la parte real y la parte imaginaria.

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

Parámetros

format: String

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

Devoluciones

String

Representación de cadena de la instancia actual en formato cartesiano.

Excepciones

FormatException

format no es una cadena de formato válido.

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)

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

.NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas 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 Framework, vea Aplicar formato a tipos.

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

Consulte también

Se aplica a

ToString(IFormatProvider)

Source:: Complex.cs

Source:: Complex.cs

Source:: Complex.cs

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

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

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 formato cartesiano, tal como especifica 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)

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

El provider parámetro 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 IFormatProvider interfaz . Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato.

Se aplica a

ToString()

Source:: Complex.cs

Source:: Complex.cs

Source:: Complex.cs

Convierte el valor del actual número complejo a su representación de cadena equivalente en formato cartesiano.

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 formato cartesiano.

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)

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 utilizando sus coordenadas cartesianas en la forma (b),, donde a es la parte real del número complejo y b es su parte imaginaria. Tanto a como b se les da formato mediante el especificador de formato general ("G") y las convenciones de la referencia cultural del sistema actual.

Se aplica a

Complex.ToString Método

Definición

Sobrecargas

ToString(String, IFormatProvider)

Parámetros

Devoluciones

Implementaciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

ToString(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

ToString(IFormatProvider)

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

ToString()

Devoluciones

Ejemplos

Comentarios

Se aplica a

Comentarios

Recursos adicionales