SPFieldLinkCollection.Add method

Artigo
05/12/2015

Adiciona um objeto de SPFieldLink à coleção.

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Sub Add ( _
    fieldLink As SPFieldLink _
)
'Uso
Dim instance As SPFieldLinkCollection
Dim fieldLink As SPFieldLink

instance.Add(fieldLink)

public void Add(
    SPFieldLink fieldLink
)

Parâmetros

fieldLink
Type: Microsoft.SharePoint.SPFieldLink

A referência de campo para adicionar à coleção. O argumento não deve ser null .

Exceptions

Exception	Condition
SPException	O valor da propriedade Name do objeto que você está adicionando à coleção duplica o valor da propriedade Name de um objeto que já existe na coleção. - ou - O objeto SPFieldLink faz referência a um campo que esteja fora do escopo deste tipo de conteúdo.

SPException

O valor da propriedade Name do objeto que você está adicionando à coleção duplica o valor da propriedade Name de um objeto que já existe na coleção.

- ou -

O objeto SPFieldLink faz referência a um campo que esteja fora do escopo deste tipo de conteúdo.

Comentários

Os objetos na coleção são indexados pelo nome interno (o valor da propriedade SPFieldLink.Name ). Se você tentar adicionar um objeto que tem o mesmo nome interno como um objeto que já existe na coleção, o método gera uma exceção. Como o valor da propriedade SPFieldLink.Name é o mesmo que a propriedade InternalName do objeto SPField que faz referência, essa restrição efetivamente garante que um tipo de conteúdo não pode fazer referência ao mesmo campo duas vezes.

Diretamente você não pode adicionar um campo do tipo SPFieldLookup se trata de uma pesquisa secundária (isto é, se a propriedade IsDependentLookup retorna true). Para adicionar campos de pesquisa secundário em uma pesquisa de várias colunas, adicione o campo de pesquisa primário (a propriedade IsDependentLookup retorna false). Todos os campos de pesquisa secundária dependem do campo de pesquisa primário são adicionados automaticamente.

Examples

O exemplo a seguir mostra um método que verifica se um tipo de conteúdo já tem um link para um campo. Se não estiver, o método cria um link e o adiciona à coleção do tipo de conteúdo.

O aplicativo que inclui este exemplo importa os namespaces System e Microsoft.Sharepoint .

Function LinkToField(ByRef field As SPField, ByRef contentType As SPContentType) As SPFieldLink
    ' Is the FieldLink in the collection?
    Dim fieldLink As SPFieldLink = contentType.FieldLinks(field.Id)
    If fieldLink Is Nothing Then ' No, so add it.
        fieldLink = New SPFieldLink(field)
        contentType.FieldLinks.Add(fieldLink)
    End If
    Return fieldLink
End Function

static SPFieldLink LinkToField(SPField field, SPContentType contentType)
{
    // Is the FieldLink in the collection?
    SPFieldLink fieldLink = contentType.FieldLinks[field.Id];
    if (fieldLink == null) // No, so add it.
    {
        fieldLink = new SPFieldLink(field);
        contentType.FieldLinks.Add(fieldLink);
    }
    return fieldLink;
}