SecurityTokenHandler.CanReadToken Método

Definição

Espaço de Nomes:
System.IdentityModel.Tokens
Assemblagem:
System.IdentityModel.dll

Devolve um valor que indica se o token especificado pode ser desserializado como token do tipo processado por esta instância.

Sobrecargas

Name Description
CanReadToken(String)

Devolve um valor que indica se a cadeia especificada pode ser desserializada como um token do tipo processado por esta instância.
CanReadToken(XmlReader)

Devolve um valor que indica se o elemento XML referenciado pelo leitor XML especificado pode ser lido como um token do tipo processado por esta instância.

CanReadToken(String)

Devolve um valor que indica se a cadeia especificada pode ser desserializada como um token do tipo processado por esta instância.

public:
 virtual bool CanReadToken(System::String ^ tokenString);
public virtual bool CanReadToken(string tokenString);
abstract member CanReadToken : string -> bool
override this.CanReadToken : string -> bool
Public Overridable Function CanReadToken (tokenString As String) As Boolean

Parâmetros

tokenString
String

A cadeia de tokens a ler.

Devoluções

Boolean

true se o ReadToken(String) método conseguir ler o elemento; caso contrário, false. A predefinição é false.

Observações

A implementação padrão sempre retorna false.

Se sobrescreveres este método, também deves sobrepor o SecurityTokenHandler.ReadToken método para fornecer a lógica para desserializar o token.

Aplica-se a

CanReadToken(XmlReader)

Devolve um valor que indica se o elemento XML referenciado pelo leitor XML especificado pode ser lido como um token do tipo processado por esta instância.

public:
 virtual bool CanReadToken(System::Xml::XmlReader ^ reader);
public virtual bool CanReadToken(System.Xml.XmlReader reader);
abstract member CanReadToken : System.Xml.XmlReader -> bool
override this.CanReadToken : System.Xml.XmlReader -> bool
Public Overridable Function CanReadToken (reader As XmlReader) As Boolean

Parâmetros

reader
XmlReader

Um leitor XML posicionado num elemento inicial. O leitor não deve ser avançado por este método.

Devoluções

Boolean

true se o ReadToken(XmlReader) método conseguir ler o elemento; caso contrário, false. A predefinição é false.

Exemplos

O código seguinte mostra como sobrescrever o CanReadToken método para determinar se um token pode ser lido por um handler. O código é retirado do Custom Token exemplo. Este exemplo fornece classes personalizadas que permitem o processamento de Simples Web Tokens (SWT). Para informações sobre esta amostra e outras amostras disponíveis para WIF e onde as descarregar, consulte Índice de Exemplos de Código WIF.

/// <summary>
/// Indicates whether the current XML element can be read as a token of the type handled by this instance.
/// </summary>
/// <param name="reader">An XML reader positioned at a start element. The reader should not be advanced.</param>
/// <returns>True if the ReadToken method can the element.</returns>
public override bool CanReadToken( XmlReader reader )
{
    bool canRead = false;

    if ( reader != null )
    {
        if ( reader.IsStartElement( BinarySecurityToken)
            && ( reader.GetAttribute( ValueType ) == SimpleWebTokenConstants.ValueTypeUri ) )
        {
            canRead = true;
        }
    }

    return canRead;
}

Observações

A implementação padrão sempre retorna false.

Uma classe derivada verifica o elemento a que o leitor se refere para determinar se a instância pode desserializar um token de segurança. Isto é normalmente feito através de uma chamada ao IsStartElement método com as strings de elementos e namespace apropriadas especificadas. Se sobrescrever CanReadKeyIdentifierClause, também deve sobrescrever o SecurityTokenHandler.ReadToken método ou o SecurityTokenHandler.ReadToken método para fornecer a lógica para desserializar a cláusula de identificador de chave.

Aplica-se a