SPFieldCollection.AddFieldAsXml-Methode (String)

Artikel
05/06/2015

Erstellt ein Feld auf Grundlage des angegebenen Schemas.

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

Syntax

'Declaration
Public Function AddFieldAsXml ( _
    strXml As String _
) As String
'Usage
Dim instance As SPFieldCollection
Dim strXml As String
Dim returnValue As String

returnValue = instance.AddFieldAsXml(strXml)

public string AddFieldAsXml(
    string strXml
)

Parameter

strXml
Typ: System.String

Eine Collaborative Application Markup Language (CAML) -Zeichenfolge, die das Schema enthält.

Rückgabewert

Typ: System.String
Eine CAML-Zeichenfolge, die den Namen des neuen Feldes.

Beispiele

Im folgenden Codebeispiel wird mithilfe von CAML zum Definieren eines Felds und fügt das Feld in der angegebenen Liste.

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

    Dim newField As String = "<Field Type=""Calculated"" " + 
    "DisplayName=""New_Field_Display_Name"" ResultType=""Currency"" " + 
    "ReadOnly=""TRUE"" Name=""New_Field_Internal_Name"">" + 
    "<Formula>=Currency_Field_Name*100</Formula>" + 
    "<FieldRefs><FieldRef Name=""Currency_Field_Name"" />" + 
    "</FieldRefs></Field>"

    fields.AddFieldAsXml(newField)
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsite = SPContext.Current.Site.AllWebs["MySite"])
{
    SPFieldCollection collFields = oWebsite.Lists["MyList"].Fields;

    string strNewField = "<Field Type=\"Calculated\" " +
    "DisplayName=\"New_Field_Display_Name\" ResultType=\"Currency\" " +
    "ReadOnly=\"TRUE\" Name=\"New_Field_Internal_Name\">" +
    "<Formula>=Currency_Field_Name*100</Formula>" +
    "<FieldRefs><FieldRef Name=\"Currency_Field_Name\" />" + 
    "</FieldRefs></Field>";

    collFields.AddFieldAsXml(strNewField);
}

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

AddFieldAsXml-Überladung

Microsoft.SharePoint-Namespace

Freigeben über