Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método String.StartsWith (String, Boolean, CultureInfo)

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Determina se o início dessa instância de cadeia de caracteres corresponde à cadeia de caracteres especificada quando comparada usando a cultura especificada.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public bool StartsWith(
	string value,
	bool ignoreCase,
	CultureInfo culture
)

Parâmetros

value
Type: System.String

A cadeia de caracteres a ser comparada.

ignoreCase
Type: System.Boolean

true para ignorar maiúsculas durante a comparação; do contrário, false.

culture
Type: System.Globalization.CultureInfo

As informações culturais que determinam como essa cadeia de caracteres e value são comparados. Se culture for null, a cultura atual será usada.

Valor Retornado

Type: System.Boolean

true se o parâmetro value corresponder ao início dessa cadeia de caracteres; caso contrário, false.

Exception Condition
ArgumentNullException

value é null.

Este método compara o value parâmetro para a subcadeia de caracteres no início da cadeia de caracteres que é o mesmo comprimento que valuee retorna um valor que indica se são iguais. São iguais, value deve ser uma cadeia de caracteres vazia (String.Empty), deve ser uma referência a essa mesma instância ou deve corresponder ao início desta instância.

Esse método executa uma comparação com o uso de maiusculas e minúsculas especificado e a cultura.

O exemplo a seguir determina se uma cadeia de caracteres ocorre no início de outra cadeia de caracteres. O StartsWith método é chamado várias vezes usando diferentes culturas que influenciam os resultados da pesquisa, diferenciação de maiusculas e minúsculas e maiusculas e minúsculas.

// This code example demonstrates the 
// System.String.StartsWith(String, ..., CultureInfo) method.

using System;
using System.Threading;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    string msg1 = "Search for the target string \"{0}\" in the string \"{1}\".\n";
    string msg2 = "Using the {0} - \"{1}\" culture:";
    string msg3 = "  The string to search ends with the target string: {0}";
    bool result = false;
    CultureInfo ci;

// Define a target string to search for.
// U+00c5 = LATIN CAPITAL LETTER A WITH RING ABOVE
    string capitalARing = "\u00c5";

// Define a string to search. 
// The result of combining the characters LATIN SMALL LETTER A and COMBINING 
// RING ABOVE (U+0061, U+030a) is linguistically equivalent to the character 
// LATIN SMALL LETTER A WITH RING ABOVE (U+00e5).
    string aRingXYZ = "\u0061\u030a" + "xyz";

// Clear the screen and display an introduction.
    Console.Clear();

// Display the string to search for and the string to search.
    Console.WriteLine(msg1, capitalARing, aRingXYZ);

// Search using English-United States culture.
    ci = new CultureInfo("en-US");
    Console.WriteLine(msg2, ci.DisplayName, ci.Name);

    Console.WriteLine("Case sensitive:");
    result = aRingXYZ.StartsWith(capitalARing, false, ci);
    Console.WriteLine(msg3, result);

    Console.WriteLine("Case insensitive:");
    result = aRingXYZ.StartsWith(capitalARing, true, ci);
    Console.WriteLine(msg3, result);
    Console.WriteLine();

// Search using Swedish-Sweden culture.
    ci = new CultureInfo("sv-SE");
    Console.WriteLine(msg2, ci.DisplayName, ci.Name);

    Console.WriteLine("Case sensitive:");
    result = aRingXYZ.StartsWith(capitalARing, false, ci);
    Console.WriteLine(msg3, result);

    Console.WriteLine("Case insensitive:");
    result = aRingXYZ.StartsWith(capitalARing, true, ci);
    Console.WriteLine(msg3, result);
    }
}

/*
Note: This code example was executed on a console whose user interface 
culture is "en-US" (English-United States).

Search for the target string "�" in the string "a�xyz".

Using the English (United States) - "en-US" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: True

Using the Swedish (Sweden) - "sv-SE" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: False

*/

.NET Framework
Disponível desde 2.0
Retornar ao início
Mostrar: