Share via


SP へFieldCollection.addFieldAsXml 方法 (sp.js)

指定されたスキーマ、 Boolean値の場合は、[フィールド オプションに基づいてフィールドを作成します。

**適用対象:**apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

SP.FieldCollection.addFieldAsXml()

戻り値

[Type]:の SPフィールド

次の例では、スキーマ情報に基づいてフィールドを作成するアプリケーション ページの [入力] ボタンを追加し、新しいフィールドを含め、お知らせリストで利用可能なフィールドを表示します。

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

    var fieldSchema = '<Field Type="Text" DisplayName="NewField" Name="NewField" />';

    function runCode() {
        var clientContext = new SP.ClientContext();
        var targetList = clientContext.get_web().get_lists().getByTitle('Announcements');
        fieldCollection = targetList.get_fields();
        fieldCollection.addFieldAsXml(fieldSchema, true, SP.AddFieldOptions.addToDefaultContentType);
        clientContext.load(fieldCollection);
        clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
    }

    function onQuerySucceeded() {
        var message = "NewField added to Announcements list.\n\nThe following fields are available:\n\n";
        var fields = '';
        var listEnumerator = fieldCollection.getEnumerator();
        while (listEnumerator.moveNext()) {
            fields += listEnumerator.get_current().get_title() + "; ";
        }
        alert(message + fields);
    }

    function onQueryFailed(sender, args) {
        alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
    }

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>

他のリソースのエンドポイント

詳細については、 FieldCollection リソースを参照してください。

エンドポイント URI 構造

http://<sitecollection>/<site>/_api/web/lists(listid)/fields/createFieldAsXml

HTTP 要求

このリソースには、次の HTTP コマンドがサポートしています。

  • 投稿

投稿の書式

POST http://<sitecollection>/<site>/_api/web/lists(listid)/fields/createFieldAsXml

リソースのパラメーター

  • parameters

パラメーター

  • schemaXml

  • addToDefaultView

  • options