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.StringEine Zeichenfolge, die den Anzeigenamen des Felds angibt.
type
Typ: Microsoft.SharePoint.SPFieldTypeEin SPFieldType -Wert, der den Typ des Felds erstellen angibt.
bRequired
Typ: System.Booleantrue 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.