Freigeben über


SPFieldCollection.Add-Methode (String, SPFieldType, Boolean)

Erstellt ein Feld in der Auflistung, basierend auf dem angegebenen Anzeigenamen, Feldtyp und booleschen Wert.

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

Syntax

'Declaration
Public Function Add ( _
    strDisplayName As String, _
    type As SPFieldType, _
    bRequired As Boolean _
) As String
'Usage
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
)

Parameter

  • strDisplayName
    Typ: System.String

    Eine Zeichenfolge, die den Anzeigenamen des Felds angibt.

  • bRequired
    Typ: System.Boolean

    true Wenn das Feld einen Wert enthalten erforderlich ist; andernfalls false.

Rückgabewert

Typ: System.String
Eine Zeichenfolge, die den internen Namen des neuen Feldes enthält.

Hinweise

Die Add -Methode kann verwendet werden, erstellen Sie ein Feld vom Typ Lookup, da dadurch eine SPException ausgelöst wird. Verwenden Sie stattdessen die AddLookup -Methode, um ein Feld dieses Typs hinzuzufügen.

Beispiele

Im folgenden Codebeispiel wird die angegebene Liste ein erforderliches Textfeld hinzugefügt.

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);
}

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, nachdem sie nicht mehr benötigt werden. Informationen zu bewährten Programmierpraktiken finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPFieldCollection Klasse

SPFieldCollection-Member

Add-Überladung

Microsoft.SharePoint-Namespace