FieldCollection.AddFieldAsXml-Methode

Erstellt ein Feld basierend auf den angegebenen Schema, der boolesche Wert und Optionen im Feld an.

Namespace:  Microsoft.SharePoint.Client
Assemblys:   Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client.Phone (in Microsoft.SharePoint.Client.Phone.dll)  Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)

Syntax

'Declaration
Public Function AddFieldAsXml ( _
    schemaXml As String, _
    addToDefaultView As Boolean, _
    options As AddFieldOptions _
) As Field
'Usage
Dim instance As FieldCollection
Dim schemaXml As String
Dim addToDefaultView As Boolean
Dim options As AddFieldOptions
Dim returnValue As Field

returnValue = instance.AddFieldAsXml(schemaXml, _
    addToDefaultView, options)
public Field AddFieldAsXml(
    string schemaXml,
    bool addToDefaultView,
    AddFieldOptions options
)

Parameter

  • schemaXml
    Typ: System.String

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

    Es muss sich nicht auf ein Nullverweis (Nothing in Visual Basic). Es muss nicht leer sein. Sie müssen eine gültige Onlinezusammenarbeit Application Markup Language (CAML) Zeichenfolge gemäß dem Schema in [MS-WSSFO2] angegeben sein, Abschnitt 2.2.9.3.3.1.

  • addToDefaultView
    Typ: System.Boolean

    Gibt an, um das Feld zur Standardansicht Liste hinzuzufügen.

    true , wenn das Feld in der Standardansicht für die Liste hinzugefügt wird; andernfalls, false.

Rückgabewert

Typ: Microsoft.SharePoint.Client.Field
Ein Field -Objekt, das neue Feld darstellt.

Ausnahmen

Ausnahme Bedingung
SPException

Eine oder mehrere Feldtypen nicht ordnungsgemäß installiert sind, die Formel für den Typ für berechnete Felder leer ist oder Fehler bei der Verarbeitung von dem angegebenen XML. Fehlercode:-2146232832.

Eine oder mehrere Feldtypen sind nicht ordnungsgemäß installiert. Fehlercode:-2130575340.

Formel ist für den Typ für berechnete Felder leer. Fehlercode:-2130575199.

SPQueryThrottledException

Der Einschränkungsgrenzwert erreicht ist. Fehlercode:-2147024860.

Es ist ein Join-Steuerung-Fehler aus. Fehlercode:-2147024749.

ArgumentException

Das Feld mit den angegebenen internen Namen oder Titel ist nicht in der Auflistung an der angegebenen Bereich vorhanden. Fehlercode:-2147024809.

UnauthorizedAccessException

Der aktuelle Benutzer verfügt nicht über ausreichende Berechtigungen. Fehlercode:-2147024891.

Beispiele

In diesem Codebeispiel wird ein Feld auf der Grundlage Schemainformationen erstellt und anschließend die verfügbaren Felder in der Ankündigungsliste, einschließlich das neue Feld angezeigt.

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class AddFieldAsXmlExample
    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;
            List targetList = site.Lists.GetByTitle("Announcements");
            FieldCollection collField = targetList.Fields;

            string fieldSchema = "<Field Type='Text' DisplayName='NewField' Name='NewField' />";
            collField.AddFieldAsXml(fieldSchema, true, AddFieldOptions.AddToDefaultContentType);

            clientContext.Load(collField);
            clientContext.ExecuteQuery();

            Console.WriteLine("NewField added to Announcements list.\n\nThe following fields are available:\n\n");
            foreach (Field myField in collField)
               Console.WriteLine(myField.Title);
        }
    }
}

Siehe auch

Referenz

FieldCollection Klasse

FieldCollection-Member

Microsoft.SharePoint.Client-Namespace