Complex.ToString Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte o valor do número complexo na representação de cadeia de caracteres equivalente.
Sobrecargas
ToString(String, IFormatProvider) |
Converte o valor do número complexo atual na representação de cadeia de caracteres equivalente em formato cartesiano, usando o formato especificado e as informações de formato específicas à cultura para suas partes reais e imaginárias. |
ToString(String) |
Converte o valor do número complexo atual na representação de cadeia de caracteres equivalente em formato cartesiano, usando o formato especificado para suas partes reais e imaginárias. |
ToString(IFormatProvider) |
Converte o valor do número complexo atual na representação de cadeia de caracteres equivalente em formato cartesiano usando as informações especificadas de formatação específica à cultura. |
ToString() |
Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente usando o formato cartesiano. |
ToString(String, IFormatProvider)
- Origem:
- Complex.cs
- Origem:
- Complex.cs
- Origem:
- Complex.cs
Converte o valor do número complexo atual na representação de cadeia de caracteres equivalente em formato cartesiano, usando o formato especificado e as informações de formato específicas à cultura para suas partes reais e imaginárias.
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
Uma cadeia de caracteres padrão ou de formato numérico personalizado.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.
Retornos
A representação de cadeia de caracteres da instância atual em formato cartesiano, conforme especificado por format
e provider
.
Implementações
Exceções
format
não é uma cadeia de caracteres de formato válida.
Exemplos
O exemplo a seguir cria uma matriz de números complexos e exibe cada um usando várias cadeias de caracteres de formato padrão, bem como CultureInfo objetos que representam as culturas inglês - Estados Unidos ("en-US") e francês - França ("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)
Comentários
A representação de cadeia de caracteres do número complexo retornado por esse método exibe o número usando suas coordenadas cartesianas no formato (
a,
b)
, em que a é a parte real do número complexo e b é sua parte imaginária. A eb são formatadas usando a cadeia de caracteres de formato especificada por format
. O parâmetro format
pode ser qualquer especificador de formato numérico padrão válido, ou uma combinação de especificadores de formato numérico personalizado. Se format
for igual a String.Empty ou for null
, as partes reais e imaginárias do número complexo serão formatadas com o especificador de formato geral ("G"). Caso format
tenha qualquer outro valor, o método lança um FormatException.
A .NET Framework fornece amplo suporte à formatação, que é descrita com mais detalhes nos seguintes tópicos:
Para obter mais informações sobre cadeias de caracteres de formato numérico, consulte Cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre formatação no .NET Framework, consulte Tipos de formatação.
O parâmetro provider
é uma implementação de IFormatProvider. Seu GetFormat método retorna um NumberFormatInfo objeto que fornece informações específicas da cultura sobre o formato dos números reais e imaginários na cadeia de caracteres retornada. Dependendo do parâmetro format
, esse objeto controla símbolos como o sinal negativo, o separador do grupo e o símbolo da vírgula decimal na cadeia de caracteres de saída. Se provider
for null
, a cadeia de caracteres retornada será formatada usando o NumberFormatInfo objeto da cultura atual.
O parâmetro provider
pode ser um dos seguintes:
Um CultureInfo objeto que representa a cultura que fornece informações de formatação
O objeto NumberFormatInfo que fornece informações de formatação.
Um objeto personalizado que implementa a interface IFormatProvider. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação.
Confira também
- Cadeias de Caracteres de Formato Numérico Padrão
- Cadeias de caracteres de formato numérico personalizado
Aplica-se a
ToString(String)
- Origem:
- Complex.cs
- Origem:
- Complex.cs
- Origem:
- Complex.cs
Converte o valor do número complexo atual na representação de cadeia de caracteres equivalente em formato cartesiano, usando o formato especificado para suas partes reais e imaginárias.
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
Uma cadeia de caracteres padrão ou de formato numérico personalizado.
Retornos
A representação de cadeia de caracteres da instância atual em formato cartesiano.
Exceções
format
não é uma cadeia de caracteres de formato válida.
Exemplos
O exemplo a seguir inicializa um número complexo e o exibe usando várias cadeias de caracteres de formato padrão.
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)
Comentários
A representação de cadeia de caracteres do número complexo retornado por esse método exibe o número usando suas coordenadas cartesianas no formato (
a,
b)
, em que a é a parte real do número complexo e b é sua parte imaginária. A eb são formatadas usando a cadeia de caracteres de formato especificada por format
. O parâmetro format
pode ser qualquer especificador de formato numérico padrão válido, ou uma combinação de especificadores de formato numérico personalizado. Se format
for igual a String.Empty ou for null
, as partes reais e imaginárias do número complexo serão formatadas com o especificador de formato geral ("G"). Caso format
tenha qualquer outro valor, o método lança um FormatException.
A .NET Framework fornece amplo suporte à formatação, que é descrita com mais detalhes nos seguintes tópicos:
Para obter mais informações sobre cadeias de caracteres de formato numérico, consulte Cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre formatação no .NET Framework, consulte Tipos de formatação.
O formato da cadeia de caracteres retornada é determinado pelo objeto NumberFormatInfo para a cultura atual. Dependendo do parâmetro format
, esse objeto controla símbolos como o sinal negativo, o separador do grupo e o símbolo da vírgula decimal na cadeia de caracteres de saída. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame a ToString(String, IFormatProvider) sobrecarga.
Confira também
- Cadeias de Caracteres de Formato Numérico Padrão
- Cadeias de caracteres de formato numérico personalizado
Aplica-se a
ToString(IFormatProvider)
- Origem:
- Complex.cs
- Origem:
- Complex.cs
- Origem:
- Complex.cs
Converte o valor do número complexo atual na representação de cadeia de caracteres equivalente em formato cartesiano usando as informações especificadas de formatação específica à cultura.
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
Um objeto que fornece informações de formatação específicas da cultura.
Retornos
A representação de cadeia de caracteres da instância atual em formato cartesiano, conforme especificado por provider
.
Exemplos
O exemplo a seguir exibe a representação de cadeia de caracteres de vários números complexos. O resultado usa as convenções de formatação das culturas inglês - Estados Unidos ("en-US") e francês - França ("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)
Comentários
A representação de cadeia de caracteres do número complexo retornado por esse método exibe o número usando suas coordenadas cartesianas no formato (
a,
b)
, em que a é a parte real do número complexo e b é sua parte imaginária. A eb são formatadas usando o especificador de formato geral ("G") e as convenções da cultura definidas por provider
.
O parâmetro provider
é uma implementação de IFormatProvider. Seu GetFormat método retorna um NumberFormatInfo objeto que fornece informações específicas da cultura sobre o formato dos números reais e imaginários na cadeia de caracteres retornada. Se provider
for null
, a cadeia de caracteres retornada será formatada usando o NumberFormatInfo objeto da cultura atual.
O parâmetro provider
pode ser um dos seguintes:
Um CultureInfo objeto que representa a cultura que fornece informações de formatação
O objeto NumberFormatInfo que fornece informações de formatação.
Um objeto personalizado que implementa a interface IFormatProvider. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação.
Aplica-se a
ToString()
- Origem:
- Complex.cs
- Origem:
- Complex.cs
- Origem:
- Complex.cs
Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente usando o formato cartesiano.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Retornos
A representação de cadeia de caracteres da instância atual em formato cartesiano.
Exemplos
O exemplo a seguir exibe a representação de cadeia de caracteres de vários números complexos. A saída usa as convenções de formatação da cultura inglês - Estados Unidos ("en-US"), que, nesse caso, é a cultura atual do sistema.
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)
Comentários
A representação de cadeia de caracteres padrão de um número complexo exibe o número usando suas coordenadas cartesianas no formato (
a,
b)
, em que a é a parte real do número complexo e b é sua parte imaginária. A eb são formatadas usando o especificador de formato geral ("G") e as convenções da cultura atual do sistema.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de