Classe UriTemplate

O modelo URI permite que você defina um conjunto de URIs estruturalmente semelhante.Modelos são compostos de duas partes, um caminho e uma consulta.Um caminho consiste em uma série de segmentos delimitados por uma barra (/).Cada segmento pode ter um valor literal, um valor da variável (escritos dentro de chaves [{}], restrita para coincidir com o conteúdo de exatamente um segmento) ou um caractere curinga (escrito como um asterisco [*] corresponde a "o resto do caminho"), que deve aparecer no final do caminho.A expressão de consulta pode ser omitida inteiramente.Se estiver presente, ele especifica uma seqüência desordenada de pares nome/valor.Elementos da expressão de consulta podem ser qualquer um dos pares literais (? x = 2) ou pares de variáveis (? x = {val}).Os valores da marcação sem paridade não são permitidos.Os exemplos a seguir mostram seqüências de caracteres de modelo válido:

• "WA/temperatura/Seattle"

• "sobre / {state} / {cidade}"

• "clima / *"

• "sobre / {state} / {cidade}? previsão = hoje

• "sobre / {state} / {cidade}? previsão = {dia}

Os modelos URI precedentes podem ser usados para organizar os relatórios de meteorologia.Segmentos entre chaves são variáveis, tudo o que é um literal.Você pode converter um UriTemplate instância em um Uri , substituindo variáveis com valores reais.Por exemplo, levando o modelo "sobre / {state} / {cidade}" e a colocação de valores para as variáveis de "{state}" e "{cidade}" oferece a você "WA/temperatura/Seattle".Devido a um URI do candidato, você pode testar se ele corresponde a um determinado modelo URI chamando Match(Uri, Uri).Você também pode usar UriTemplate instâncias para criar um Uri de um conjunto de valores de variável chamando BindByName(Uri, NameValueCollection) ou BindByPosition(Uri, String[]).

O código a seguir demonstra como criar um UriTemplate de instância e vincular e corresponder a um candidato URI.

UriTemplate template = new UriTemplate("weather/{state}/{city}?forecast={day}");
Uri prefix = new Uri("http://localhost");

Console.WriteLine("PathSegmentVariableNames:");
foreach (string name in template.PathSegmentVariableNames)
{
    Console.WriteLine("     {0}", name);
}
Console.WriteLine();

Console.WriteLine("QueryValueVariableNames:");
foreach (string name in template.QueryValueVariableNames)
{
    Console.WriteLine("     {0}", name);
}
Console.WriteLine();

Uri positionalUri = template.BindByPosition(prefix, "Washington", "Redmond", "Today");

NameValueCollection parameters = new NameValueCollection();
parameters.Add("state", "Washington");
parameters.Add("city", "Redmond");
parameters.Add("day", "Today");
Uri namedUri = template.BindByName(prefix, parameters);

Uri fullUri = new Uri("http://localhost/weather/Washington/Redmond?forecast=today");
UriTemplateMatch results = template.Match(prefix, fullUri);

Console.WriteLine("Matching {0} to {1}", template.ToString(), fullUri.ToString());

if (results != null)
{
    foreach (string variableName in results.BoundVariables.Keys)
    {
        Console.WriteLine("   {0}: {1}", variableName, results.BoundVariables[variableName]);
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

Referência