Partilhar via


Criando Novas Sequências de Caracteres

O .NET Framework permite que seqüências de caracteres a ser criado usando uma atribuição simples e também sobrecarrega um construtor de classe para dar suporte à criação de seqüência de caracteres usando um número de parâmetros diferentes. O .NET Framework também fornece vários métodos de System.String classe que criar novos objetos de cadeia de caracteres, combinando várias cadeias de caracteres, matrizes de seqüências de caracteres, ou objetos.

A criação de seqüências de caracteres usando atribuição

A maneira mais fácil de criar uma nova String é o objeto atribuir uma seqüência literal para simplesmente um String objeto.

A criação de seqüências de caracteres usando um construtor de classe

Você pode usar sobrecargas do String o construtor de classe para criar seqüências de caracteres de conjuntos de caracteres. Você também pode criar uma nova seqüência duplicando um determinado caractere, um número de vezes especificado.

Métodos que retornam seqüências de caracteres

A tabela a seguir lista vários métodos úteis que retornam os novos objetos de cadeia de caracteres.

Nome do Método

Uso

String.Format

Cria uma sequência formatada de caracteres a partir de um conjunto de objetos de entrada.

String.Concat

Cria as sequências de caracteres a partir de dois ou mais sequências de caracteres.

String.Join

Cria uma nova sequência de caracteres ao combinar uma matriz de sequências de caracteres.

String.Insert

Cria uma nova sequência ao inserir uma sequência de caracteres no índice especificado de uma sequência existente.

String.CopyTo

Cópias determinados caracteres de uma sequência de caracteres em uma posição especificada em uma matriz de caracteres.

Formato

Você pode usar o método String.Format para criar sequências formatadas de caracteres e concatenar as sequências de caracteres que representam vários objetos. Este método converte automaticamente qualquer objeto passado em uma sequncia de caracteres. Por exemplo, se seu aplicativo deve exibir um valor Int32 DateTime para o usuário, você pode facilmente construir uma sequência de caracteres para representar esses valores usando o método Format. Para obter informações sobre as convenções de formatação usadas com esse método, consulte a seção em Composição Formatação.

O exemplo a seguir usa o método Format para criar uma sequência de caracteres que usa uma variável do tipo inteiro.

Dim numberOfFleas As Integer = 12
Dim miscInfo As String = String.Format("Your dog has {0} fleas. " & _
                                       "It is time to get a flea collar. " & _ 
                                       "The current universal date is: {1:u}.", _ 
                                       numberOfFleas, Date.Now)
Console.WriteLine(miscInfo)
' The example displays the following output:
'       Your dog has 12 fleas. It is time to get a flea collar. 
'       The current universal date is: 2008-03-28 13:31:40Z.
int numberOfFleas = 12;
string miscInfo = String.Format("Your dog has {0} fleas. " +
                                "It is time to get a flea collar. " + 
                                "The current universal date is: {1:u}.", 
                                numberOfFleas, DateTime.Now);
Console.WriteLine(miscInfo);
// The example displays the following output:
//       Your dog has 12 fleas. It is time to get a flea collar. 
//       The current universal date is: 2008-03-28 13:31:40Z.

Neste exemplo,DateTime.Now exibe a data e hora atuais de maneira especificada pela cultura associada a thread atual.

Concat

O método String.Concat pode ser usado para criar facilmente um novo objeto de sequência de caracteres a partir de dois ou mais objetos existentes. Ele fornece uma maneira independente de linguagem para concatenar as sequências de caracteres. Este método aceita qualquer classe que é derivada de System.Object. O exemplo a seguir cria uma sequência de caracteres a partir de dois objetos de sequência de caracteres existentes e um caractere de separação.

Dim helloString1 As String = "Hello"
Dim helloString2 As String = "World!"
Console.WriteLine(String.Concat(helloString1, " "c, helloString2))
' The example displays the following output:
'      Hello World!
string helloString1 = "Hello";
string helloString2 = "World!";
Console.WriteLine(String.Concat(helloString1, ' ', helloString2));
// The example displays the following output:
//      Hello World!

Join

O método String.JOIN cria uma nova sequência de caracteres a partir de uma matriz de sequências de caracteres e um separador de sequência de caracteres. Este método é útil se você quiser concatenar várias sequências de caracteres juntas, fazendo uma lista talvez separada por uma vírgula.

O exemplo a seguir usa um espaço para vincular uma matriz de sequências de caracteres.

Dim words() As String = {"Hello", "and", "welcome", "to", "my" , "world!"}
Console.WriteLine(String.Join(" ", words))
' The example displays the following output:
'      Hello and welcome to my world!
string[] words = {"Hello", "and", "welcome", "to", "my" , "world!"};
Console.WriteLine(String.Join(" ", words));
// The example displays the following output:
//      Hello and welcome to my world!

Inserir

O método String.Insert cria uma nova sequência ao inserir uma sequência de caracteres em uma posição especificada em outra sequência de caracteres. Esse método usa um índice com base zero. O exemplo a seguir insere uma sequência de caracteres na quinta posição do MyString e cria uma nova sequência de caracteres com esse valor.

Dim sentence As String = "Once a time."   
 Console.WriteLine(sentence.Insert(4, " upon"))
 ' The example displays the following output:
 '      Once upon a time.
string sentence = "Once a time.";   
 Console.WriteLine(sentence.Insert(4, " upon"));
 // The example displays the following output:
 //      Once upon a time.

CopyTo

O método String.CopyTo copia partes de uma sequência de caracteres em uma matriz de caracteres. Você pode especificar tanto o índice inicial da sequência de caracteres quanto o número de caracteres a serem copiados. Este método utiliza o índice da origem, uma matriz de caracteres, o índice de destino e o número de caracteres a serem copiados. Todos os índices são baseados em zero.

O exemplo a seguir usa o método CopyTo para copiar os caracteres da palavra "Hello" de um objeto de sequência de caracteres para a posição do primeiro índice de uma matriz de caracteres.

Dim greeting As String = "Hello World!"
Dim charArray() As Char = {"W"c, "h"c, "e"c, "r"c, "e"c}
Console.WriteLine("The original character array: {0}", New String(charArray))
greeting.CopyTo(0, charArray,0 ,5)
Console.WriteLine("The new character array: {0}", New String(charArray))
' The example displays the following output:
'       The original character array: Where
'       The new character array: Hello
string greeting = "Hello World!";
char[] charArray = {'W','h','e','r','e'};
Console.WriteLine("The original character array: {0}", new string(charArray));
greeting.CopyTo(0, charArray,0 ,5);
Console.WriteLine("The new character array: {0}", new string(charArray));
// The example displays the following output:
//       The original character array: Where
//       The new character array: Hello

Consulte também

Conceitos

Formatação Composta

Outros recursos

Operações Básicas com Sequências de Caracteres