Compartir a través de


(String, SPFieldType, Boolean) del método SPFieldCollection.Add

Crea un campo de la colección basándose en el nombre para mostrar especificado, el tipo de campo y el valor Boolean.

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

Sintaxis

'Declaración
Public Function Add ( _
    strDisplayName As String, _
    type As SPFieldType, _
    bRequired As Boolean _
) As String
'Uso
Dim instance As SPFieldCollection
Dim strDisplayName As String
Dim type As SPFieldType
Dim bRequired As Boolean
Dim returnValue As String

returnValue = instance.Add(strDisplayName, _
    type, bRequired)
public string Add(
    string strDisplayName,
    SPFieldType type,
    bool bRequired
)

Parámetros

  • strDisplayName
    Tipo: System.String

    Una cadena que especifica el nombre para mostrar del campo.

  • bRequired
    Tipo: System.Boolean

    true si el campo es necesario para contener un valor; en caso contrario, false.

Valor devuelto

Tipo: System.String
Una cadena que contiene el nombre interno del nuevo campo.

Comentarios

El método Add no se puede usar para crear un campo de tipo Lookup, ya que esto hace que un SPException que se inicie. En su lugar, use el método AddLookup para agregar un campo de este tipo.

Ejemplos

En el ejemplo de código siguiente se agrega un campo de texto requerido para la lista especificada.

Dim webSite As SPWeb = SPContext.Current.Site.AllWebs("MySite")
Try
    Dim fields As SPFieldCollection = webSite.Lists("MyList").Fields

    fields.Add("MyField", Microsoft.SharePoint.SPFieldType.Text, True)
Finally
    webSite.Dispose()
End Try
using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["MySite"])
{
    SPFieldCollection collFields = oWebsite.Lists["MyList"].Fields;
    collFields.Add("MyField", Microsoft.SharePoint.SPFieldType.Text, 
        true);
}

Nota

Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.

Vea también

Referencia

clase SPFieldCollection

Miembros SPFieldCollection

Sobrecarga Add

Espacio de nombres Microsoft.SharePoint