Freigeben über

NEWFIELD-Methode

  • Artikel

Letzte Änderung: Freitag, 30. Mai 2008

Gilt für: SharePoint Foundation 2010

Fügt einer SharePoint-Liste ein Feld hinzu.

HinweisHinweis

Diese Methode ist veraltet und wird in zukünftigen Versionen möglicherweise nicht mehr unterstützt. Verwenden Sie stattdessen die folgende Webdienstmethode:UpdateList(String, XmlNode, XmlNode, XmlNode, XmlNode, String)-Webdienstmethode.

 
<Method ID="Text">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;fieldname&quot;
    MaxLength=&quot;Integer&quot; DisplayName=&quot;displayname&quot;
    Description=&quot;text&quot; Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">[ON|OFF]</SetVar>
  <SetVar Name="owshiddenversion">Integer</SetVar>
</Method>

Parameter

Parameter

Beschreibung

ID = "Text"

Anwendungsspezifische Zeichenfolge. In einem mit Microsoft Windows SharePoint Services kompatiblen HTML-Editor, z. B. Microsoft Office SharePoint Server 2007, gibt die Zeichenfolge die Sequenznummer und den Namen der Methode an.

Scope = "Request"

Wenn das Scope-Attribut auf Request festgelegt ist, wird die Variable für den Bereich des einschließenden Method-Elements festgelegt, es sei denn, die Variable wird von einem anderen Tag geändert.

Name = "Cmd"

Muss auf NEWFIELD festgelegt sein.

Name = "FieldXML"

Die XML-Beschreibung des neuen Felds. Den vollständigen Satz der verfügbaren Attribute und Werte, die eingefügt werden können, finden Sie in der Definition des Field-Elements in der Referenz zu CAML-Hauptschemas (Collaborative Application Markup Language).

Name = "AddToDefaultView"

Eine Ansicht ist ein benannter Satz von Regeln, die beschreiben, wie die Elemente in einer Liste angezeigt werden. Jede Liste verfügt über eine Standardansicht, die ihr zugeordnet ist. Wenn AddToDefaultView auf ON festgelegt ist, wird das Feld der Standardansicht hinzugefügt. Bei Festlegung auf OFF ist das Gegenteil der Fall.

Name = "owshiddenversion"

Dies ist die aktuelle Versionsnummer der Liste. Der NEWFIELD-Befehl funktioniert nur, wenn Windows SharePoint Services und die Clientanwendung die Versionsnummer der Liste aufeinander abstimmen. Dadurch wird sichergestellt, dass nur ein Benutzer gleichzeitig das Listenschema ändern kann.

Decodiert

<Method ID="0,NEWFIELDSample">
  <SetList Scope="Request">GUID</SetList>
  <SetVar Name="Cmd">NEWFIELD</SetVar>
  <SetVar Name="FieldXML">&lt;Field Name=&quot;Sample&quot;
    MaxLength=&quot;255&quot; DisplayName=&quot;Sample&quot;
    Description=&quot;sample description&quot; 
        Type=&quot;Text&quot;/&gt;</SetVar>
  <SetVar Name="AddToDefaultView">ON</SetVar>
  <SetVar Name="owshiddenversion">6</SetVar>
</Method>

Siehe auch

Konzepte

Fehlermeldungsformat für SharePoint Foundation