Método ReplicaMetadata.FindItemMetadataByUniqueIndexedField

Artigo
10/17/2009

Quando substituído em uma classe derivada, retorna a entrada de metadados do item exclusiva que tem o valor especificado para o campo indexado.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (em microsoft.synchronization.metadatastorage.dll)

Sintaxe

'Declaração
Public MustOverride Function FindItemMetadataByUniqueIndexedField ( _
    fieldName As String, _
    fieldValue As Object _
) As ItemMetadata
'Uso
Dim instance As ReplicaMetadata
Dim fieldName As String
Dim fieldValue As Object
Dim returnValue As ItemMetadata

returnValue = instance.FindItemMetadataByUniqueIndexedField(fieldName, fieldValue)

public abstract ItemMetadata FindItemMetadataByUniqueIndexedField (
    string fieldName,
    Object fieldValue
)

public:
virtual ItemMetadata^ FindItemMetadataByUniqueIndexedField (
    String^ fieldName, 
    Object^ fieldValue
) abstract

public abstract ItemMetadata FindItemMetadataByUniqueIndexedField (
    String fieldName, 
    Object fieldValue
)

public abstract function FindItemMetadataByUniqueIndexedField (
    fieldName : String, 
    fieldValue : Object
) : ItemMetadata

Parâmetros

fieldName
O nome do campo indexado exclusivo. O campo deve ser válido e um campo de índice exclusivo.

fieldValue
O valor do campo indexado exclusivo.

Valor de retorno

A entrada de metadados exclusiva que tem o valor especificado para o campo indexado. Um referência nula (Nothing no Visual Basic) é retornado quando não há nenhum item.

Exceções

Tipo de exceção	Condição
ObjectDisposedException	O objeto foi descartado ou não foi inicializado corretamente.
ArgumentNullException	fieldName ou fieldValue é um referência nula (Nothing no Visual Basic).
ArgumentException	fieldName tem comprimento 0 ou fieldValue é do tipo string e tem comprimento 0.
NotSupportedException	Não há suporte para o tipo de fieldValue.
MetadataFieldNotFoundException	fieldName não foi localizado ou não é válido.
MetadataStoreInvalidOperationException	O campo especificado não é um índice exclusivo.

Comentários

Os campos personalizados devem ser estabelecidos quando os metadados da réplica são inicializados pela primeira vez, passando FieldSchema para InitializeReplicaMetadata.

Os campos de índice devem ser estabelecidos e marcados como exclusivos quando os metadados da réplica são inicializados pela primeira vez, passando IndexSchema para InitializeReplicaMetadata.

Consulte também

Referência

Classe ReplicaMetadata
Membros ReplicaMetadata
Namespace Microsoft.Synchronization.MetadataStorage

Compartilhar via