Compartilhar via


Regex.GroupNumberFromName(String) Método

Definição

Retorna o número do grupo que corresponde ao nome do grupo especificado.

public:
 int GroupNumberFromName(System::String ^ name);
public int GroupNumberFromName (string name);
member this.GroupNumberFromName : string -> int
Public Function GroupNumberFromName (name As String) As Integer

Parâmetros

name
String

O nome do grupo a ser convertido para o número de grupo correspondente.

Retornos

Int32

O número do grupo que corresponde ao nome do grupo especificado ou -1 se name não for um nome de grupo válido.

Exceções

name é null.

Comentários

Um padrão de expressão regular pode conter grupos de captura nomeados ou numerados, que delineam subexpressões dentro de uma correspondência de padrão. Os grupos numerados são delimitados pela sintaxe (subexpressão) e são atribuídos números com base em sua ordem na expressão regular. Os grupos nomeados são delimitados pela sintaxe (?< Nome> subexpressão) ou (?' name'subexpression), onde o nome é o nome pelo qual a subexpressão será identificada. (Para obter mais informações, consulte Construções de agrupamento.) O GroupNumberFromName método identifica grupos nomeados e grupos numerados por suas posições ordinais na expressão regular. A posição ordinal zero sempre representa toda a expressão regular. Todos os grupos numerados são contados antes dos grupos nomeados, independentemente de sua posição real no padrão de expressão regular.

Se name for a representação de cadeia de caracteres de um número de grupo presente no padrão de expressão regular, o método retornará esse número. Se name corresponder a um grupo de captura nomeado presente no padrão de expressão regular, o método retornará seu número correspondente. A comparação com name o nome do grupo diferencia maiúsculas de minúsculas. Se name não corresponder ao nome de um grupo de captura ou à representação de cadeia de caracteres do número de um grupo de captura, o método retornará -1.

Aplica-se a

Confira também