del método FieldCollection.AddFieldAsXml
Crea un campo basado en el esquema especificado, valor booleano y opciones de campo.
Espacio de nombres: Microsoft.SharePoint.Client
Ensamblados: Microsoft.SharePoint.Client.Silverlight (en Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (en Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (en Microsoft.SharePoint.Client.dll)
Sintaxis
'Declaración
Public Function AddFieldAsXml ( _
schemaXml As String, _
addToDefaultView As Boolean, _
options As AddFieldOptions _
) As Field
'Uso
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
)
Parámetros
schemaXml
Tipo: System.StringUna cadena de aplicación marcado CAML (lenguaje) que contiene el esquema.
No debe ser una referencia null (Nothing en Visual Basic). No debe estar vacía. Debe ser una cadena de aplicación marcado CAML (lenguaje) válida según el esquema especificado en [MS WSSFO2], sección 2.2.9.3.3.1.
addToDefaultView
Tipo: System.BooleanEspecifica que se agregue el campo a la vista de lista predeterminada.
true si el campo se agrega a la vista de lista predeterminada; en caso contrario, false.
options
Tipo: Microsoft.SharePoint.Client.AddFieldOptionsUn valor de AddFieldOptions que especifica las opciones de campo.
Valor devuelto
Tipo: Microsoft.SharePoint.Client.Field
Objeto Field que representa el nuevo campo.
Excepciones
| Excepción | Condición |
|---|---|
| SPException | Uno o más tipos de campo no se instalan correctamente, la fórmula está vacía para el tipo de campo calculado o se produjo un error durante el procesamiento de XML especificado. Código de error:-2146232832. Uno o más tipos de campo no se instalan correctamente. Código de error:-2130575340. Fórmula está vacía para el tipo de campo calculado. Código de error:-2130575199. |
| SPQueryThrottledException | Se ha alcanzado el límite. Código de error:-2147024860. Hay un error de límite de combinación. Código de error:-2147024749. |
| ArgumentException | El campo con el nombre interno especificado o el título no existe en el ámbito determinado de la colección. Código de error: -2147024809. |
| UnauthorizedAccessException | El usuario actual no tiene permisos suficientes. Código de error: -2147024891. |
Ejemplos
Este ejemplo de código crea un campo en función de la información de esquema y, a continuación, muestra los campos disponibles en la lista anuncios, incluido el nuevo campo.
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);
}
}
}