del método SPFieldLinkCollection.Add

Agrega un objeto SPFieldLink a la colección.

Espacio de nombres:  Microsoft.SharePoint
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
  Tipo: Microsoft.SharePoint.SPFieldLink

  Referencia de campo que se va a agregar a la colección. El argumento no debe ser nulo .

Excepciones

Comentarios

Objetos de la colección se indizan por su nombre interno (el valor de la propiedad SPFieldLink.Name ). Si intenta agregar un objeto que tiene el mismo nombre interno como un objeto que ya existe en la colección, el método produce una excepción. Dado que el valor de la propiedad SPFieldLink.Name es el mismo que la propiedad InternalName del objeto SPField que hace referencia, esta restricción eficazmente se asegura de que un tipo de contenido no puede hacer referencia al mismo campo dos veces.

No se puede agregar directamente un campo de tipo SPFieldLookup si es una búsqueda secundaria (es decir, si la propiedad IsDependentLookup devuelve true). Para agregar campos de búsqueda secundaria en una búsqueda de varias columnas, agregue el campo de búsqueda principal (la propiedad IsDependentLookup devuelve false). Todos los campos de búsqueda secundaria que dependen del campo de búsqueda principal se agregan automáticamente.

Ejemplos

El ejemplo siguiente muestra un método que comprueba si un tipo de contenido ya tiene un vínculo a un campo. Si no es así, el método crea un vínculo y lo agrega a la colección del tipo de contenido.

La aplicación que se incluye en este ejemplo importa los espacios de nombres System y 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;
}

Vea también

Referencia

clase SPFieldLinkCollection

Miembros SPFieldLinkCollection

Espacio de nombres Microsoft.SharePoint

SPFieldLink

SPContentType

Otros recursos

Fields and Field References

Introduction to Columns