A classe Convert(.NET) possui um vasto número de métodos para conversão de dados que podem usados em C#. Nesta parte do tutorial, vamos estudar alguns métodos mais comuns dessa classe.

Sintaxe

Convert.nome_metodo(argumento);

Alguns os métodos mostrados abaixo lançam erro ou exceção caso a conversão de dados não tenha sucesso. Outros retornam 0 ou 1 como resultado.

Os tipos de dados primitivos utilizados nesta seção foram vistos em C# Básico: Tipos de Dados. Outros tipos como DateTime serão vistos em futuras atualizações.

Com o método ChangeType podemos converter um objeto para um determinado tipo de dado. Um erro é gerado caso a conversão não possa ser realizada.

Sintaxe

public static object? ChangeType(object? value, Type conversionType);

Onde

value: objeto/valor para conversão
conversionType: tipo de dado para conversão.

Retorno

value convertido para tipo conversionType.

Exemplo 1

using System;	
public class Program
{
	public static void Main()
	{
		string str1 = "false";
		Object ret = Convert.ChangeType(str1,typeof(Boolean));
		Console.WriteLine(ret);
	}
}

Saída

False

Com os métodos FromHexString e ToHexString, podemos converter uma string para um array de bytes e vice-versa.

Sintaxe

public static byte[] FromHexString(string s);

public static byte[] ToHexString(byte[] inArray);

Onde

s: string para conversão
inArray: array de bytes para conversão.

Retorno

s: convertido para byte[]
inArray: convertido para string

Exemplo 2

using System;
					
public class Program
{
	public static void Main()
	{
		string str1 = "ffeeddccbbaa";
		byte[] array = Convert.FromHexString(str1);
		
		foreach ( byte b in array)
		  Console.Write(b);

		Console.WriteLine();
		string str2 = Convert.ToHexString(array);
		Console.WriteLine(str2);
	}
}

Saída

255238221204187170
FFEEDDCCBBAA

Utilizando o método ToBoolean podemos converter valores string ou inteiro, por exemplo, para o tipo de dado Boolean.

Sintaxe

public static bool ToBoolean(byte value);

Onde

value: valor string, byte, char, decimal, double, int e outros

Retorno

value convertido para boolean

Exemplo 3

using System;
					
public class Program
{
	public static void Main()
	{
		Console.WriteLine(Convert.ToBoolean(1));
		Console.WriteLine(Convert.ToBoolean(0));
		Console.WriteLine(Convert.ToBoolean("true"));
		Console.WriteLine(Convert.ToBoolean("false"));
	}
}

Saída

True
False
True
False

Usando o método de conversão ToDateTime, podemos converter data contidas em strings, por exemplo, para o formato DateTime que armazena informações data-hora.

Sintaxe

public static DateTime ToDateTime(string? value);

Onde

value: valor string para conversão

Retorno

value convertido para DateTime

Exemplo 4

using System;	
public class Program
{
	public static void Main()
	{
	  Console.WriteLine(Convert.ToDateTime("01/31/2024"));
	  Console.WriteLine(Convert.ToDateTime("01-01-2024"));
	  Console.WriteLine(Convert.ToDateTime("01-31-2024"));
	}
}

Saída

01/31/2024 00:00:00
01/01/2024 00:00:00
01/31/2024 00:00:00

O tipo de dados DateTime pode ser visto em Classes Nativas: DateTime com mais detalhes.

Fazendo udo do método ToDecimal, podemos converter valores int, float e string, por exemplo, para o formato decimal.

Sintaxe

public static decimal ToDecimal(object? value);

Onde

value: valor para conversão: string, byte, int, bool, char e outros

Retorno

value convertido para decimal

Exemplo 5

using System;
					
public class Program
{
	public static void Main()
	{
		Console.WriteLine(Convert.ToDecimal(100));
		Console.WriteLine(Convert.ToDecimal(1.99F));
		Console.WriteLine(Convert.ToDecimal("10.50"));
	}
}

Saída

100
1.99
10.50

O método ToDouble é utilizado para converter valores int, float e string, por exemplo, para o formato double.

Sintaxe

public static double ToDouble(object? value);

Onde

value: valor para conversão: string, byte, int, bool, char e outros

Retorno

value convertido para double

Exemplo 6

using System;
					
public class Program
{
	public static void Main()
	{
		Console.WriteLine(Convert.ToDouble(100));
		Console.WriteLine(Convert.ToDouble(1.12345));
		Console.WriteLine(Convert.ToDouble("10.50"));
	}
}

Saída

100
1.12345
10.5

Com o método ToString, podemos converter valores int, float e boolean, por exemplo, para o formato string.

Sintaxe

public static string ToString(object? value);

Onde

value: valor para conversão: string, byte, int, bool, char e outros

Retorno

value convertido para string

Exemplo 7

using System;
					
public class Program
{
	public static void Main()
	{
		Console.WriteLine(Convert.ToString(100));
		Console.WriteLine(Convert.ToString(1.12345));
		Console.WriteLine(Convert.ToString(true));
		Console.WriteLine(Convert.ToString('A'));
	}
}

Saída

1100
1.12345
True
A

Os métodos ToIn32/ToUint32 são utilizado para converter valores byte, int e bool, por exemplo, para o formato inteiro sinalizado e não-sinalizado.

Sintaxe

public static Int32 ToInt32(object? value);

public static Int32 ToUInt32(object? value);

Onde

value: valor para conversão: string, byte, int, bool, char e outros

Retorno

value convertido para string

Exemplo 8

using System;
					
public class Program
{
	public static void Main()
	{
		Console.WriteLine(Convert.ToInt32(true));
		Console.WriteLine(Convert.ToInt32("100"));
		Console.WriteLine(Convert.ToInt32('A'));
		
		Console.WriteLine(Convert.ToUInt32("16777215"));
		Console.WriteLine(Convert.ToUInt32(true));
		Console.WriteLine(Convert.ToUInt32(0xffff));
	}
}

Saída

1
100
65
16777215
1
65535

A sinalização de valores foi visto em Tutorial C: Sinalização.

Para a conversão entre codificações de caracteres, ASCII, Unicode, UTF-8 e outras, o namespace System.Text fornece recursos para tal fim.

Sintaxe

using System.Text

Os métodos GetBytes e GetString são usados respectivamente para recuperar os bytes contidos em uma string em uma codificação e o segundo retorna uma string definida em uma codificação.

Sintaxe

Encoding.nome_encode.GetBytes(char[] array)
Encoding.nome_encode.GetString(char[] array)

No exemplo abaixo, uma string UTF-16(2 bytes) padrão de C# é convertida para ASCII(1 byte). As propriedades Length são utilizadas para mostrar a diferença entre quantidade de caracteres nas string e seus tamanhos reais em bytes ocupados em memória.

Exemplo 9

using System;
using System.Text;

class HelloWorld 
{
  static void Main() 
  {
	    //UTF-16 
	    string str = "string C# ç"; //default utf-16
	    Console.WriteLine(str);
	    Console.WriteLine("length: {0}",str.Length);
		byte[] strBytes = Encoding.Default.GetBytes(str.ToCharArray()); //conversão p/ bytes
	    Console.WriteLine("size: {0}\n",strBytes.Length);
	   
	    //ASCII
	    string strAscii = Encoding.ASCII.GetString(strBytes); //conversão UTF-16 -> ASCII
	    Console.WriteLine(strAscii);
	    Console.WriteLine("\nlength: {0}",strAscii.Length);
		strBytes = Encoding.ASCII.GetBytes(strAscii.ToCharArray()); 
	    Console.WriteLine("size: {0}",strBytes.Length);
  }
}

Saída

string C# ç
length: 11
size: 12

string C# ç

length: 12
size: 12

1. 16/06/2026 - revisão 3 - Adição: Encoding
2. 05/08/2025 - revisão 2 - Correções: pontuais, link internot 'Tipos de dados','Objetivos', sintaxes'
3. 14/10/2024 - revisão 1 - Correção: 'ToString' ; Ajustes pontuais
4. 12/03/2024 - versão inicial