【发布时间】:2016-01-07 14:38:37
【问题描述】:
是否可以使用 CSOM 在 SharePoint 中创建字段,而不是使用 XML?
我见过很多使用 XML 的示例,但没有一个只是以编程方式设置字段的属性?
fields.Add(new **FieldCreationInformation** {
InternalName = "Test",
etc..
});
【问题讨论】:
标签: sharepoint csom
是否可以使用 CSOM 在 SharePoint 中创建字段,而不是使用 XML?
我见过很多使用 XML 的示例,但没有一个只是以编程方式设置字段的属性?
fields.Add(new **FieldCreationInformation** {
InternalName = "Test",
etc..
});
【问题讨论】:
标签: sharepoint csom
这是可行的,在下面的例子中引入了一个FieldCreationInformation class:
[XmlRoot("Field")]
public class FieldCreationInformation
{
[XmlAttribute("ID")]
public Guid Id { get; set; }
[XmlAttribute()]
public string DisplayName { get; set; }
[XmlAttribute("Name")]
public string InternalName { get; set; }
[XmlIgnore()]
public bool AddToDefaultView { get; set; }
//public IEnumerable<KeyValuePair<string, string>> AdditionalAttributes { get; set; }
[XmlAttribute("Type")]
public FieldType FieldType { get; set; }
[XmlAttribute()]
public string Group { get; set; }
[XmlAttribute()]
public bool Required { get; set; }
public string ToXml()
{
var serializer = new XmlSerializer(GetType());
var settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
var emptyNamepsaces = new XmlSerializerNamespaces(new[] { XmlQualifiedName.Empty });
using (var stream = new StringWriter())
using (var writer = XmlWriter.Create(stream, settings))
{
serializer.Serialize(writer, this, emptyNamepsaces);
return stream.ToString();
}
}
public FieldCreationInformation()
{
Id = Guid.NewGuid();
}
}
然后是创建新字段的扩展方法:
public static class FieldCollectionExtensions
{
public static Field Add(this FieldCollection fields, FieldCreationInformation info)
{
var fieldSchema = info.ToXml();
return fields.AddFieldAsXml(fieldSchema, info.AddToDefaultView, AddFieldOptions.AddFieldToDefaultView);
}
}
用法
var fieldInfo = new FieldCreationInformation();
fieldInfo.FieldType = FieldType.Geolocation;
fieldInfo.InternalName = "ContactsLocation";
fieldInfo.DisplayName = "Contacts Location";
ctx.Site.RootWeb.Fields.Add(fieldInfo);
ctx.ExecuteQuery();
【讨论】:
fields.AddFieldAsXml 调用中添加AddFieldOptions.AddFieldInternalNameHint:return fields.AddFieldAsXml(fieldSchema, info.AddToDefaultView, AddFieldOptions.AddFieldToDefaultView | AddFieldOptions.AddFieldInternalNameHint);
当我使用 CSOM/JSOM 添加字段时,我使用 FieldCollection AddFieldAsXml 上的方法。这需要您使用所需字段的所有属性构建一个 xml 字符串,但它可以工作。我在下面包含了相关 cpde 的摘录:
Microsoft.SharePoint.Client.Web web = _context.Web;
FieldCollection fields = web.Fields;
_context.Load(fields);
_context.ExecuteQuery();
Field field = fields.FirstOrDefault(f => f.StaticName == _staticName);
if (field == null)
{
Field createdField = fields.AddFieldAsXml(xml, false, AddFieldOptions.AddToNoContentType);
_context.Load(createdField);
_context.ExecuteQuery();
}
如果您想将字段直接添加到现有列表,则使用类似代码。
【讨论】:
Add 的方法,它接受一个 Field 对象,但是 Field 的 constructor 并没有提供一种愉快的方法来实例化一个(需要 Context 和 ObjectPath) 是否有理由需要在其中添加一个 Field方式?