0

0

SharePoint如何上传和解析XML文件 CSOM和REST API

月夜之吻

月夜之吻

发布时间:2026-02-02 12:33:08

|

692人浏览过

|

来源于php中文网

原创

CSOM上传XML最稳妥,需设ContentStream和.xml后缀,启用自定义脚本;REST上传须移除DOCTYPE声明并用multipart/form-data;解析需下载二进制流后用UTF8解码再XDocument解析。

sharepoint如何上传和解析xml文件 csom和rest api

CSOM 上传 XML 文件到文档库

CSOM 是最稳妥的上传方式,尤其适合需要保持文件元数据、权限继承或批量操作的场景。XML 文件本质是二进制流,和上传 .txt 或 .csv 没区别,但要注意 Content-Type 和文件扩展名是否被 SharePoint 服务端拦截。

关键点:FileCreationInformation 必须设置 ContentStream(不能用字符串直接赋值),且 Url 字段要包含 .xml 后缀;否则上传成功但可能无法下载或触发解析失败。

  • 确保目标文档库允许上传 .xml 文件(默认部分租户禁用,需在 SharePoint 管理中心 → More featuresCustom Script 开启,或由管理员在 Site Settings → Site Collection Features 中启用「自定义脚本」)
  • 使用 Web.GetFolderByServerRelativeUrl() 获取目标文件夹,避免硬编码 URL 路径中的空格或编码问题
  • 上传后建议调用 file.ListItemAllFields.Update() 并执行 context.ExecuteQuery(),确保后续能通过 REST 获取元数据
var fileCreationInfo = new FileCreationInformation
{
    ContentStream = new MemoryStream(Encoding.UTF8.GetBytes(xmlContent)),
    Url = "config.xml",
    Overwrite = true
};
var folder = context.Web.GetFolderByServerRelativeUrl("/sites/demo/Shared Documents");
var uploadFile = folder.Files.Add(fileCreationInfo);
context.Load(uploadFile);
context.ExecuteQuery();

REST API 上传 XML 文件(无 CSOM 环境)

REST 方式更轻量,适合前端或无 .NET 运行时的场景,但必须注意:SharePoint Online 默认会阻止某些 MIME 类型的 XML 上传,尤其是带 DTD 或 DOCTYPE 声明的文件。错误现象通常是 403 Forbidden500 Server Error,响应体里含 "The file is not supported for security reasons."

解决办法不是改请求头,而是调整 XML 内容本身:

  • 移除所有 /code> 和 声明(SharePoint REST 对 XML 声明敏感,即使合法也会被拦截)
  • 确保 Content-Type 请求头设为 application/xmltext/xml,但实际上传时用 multipart/form-data 更可靠
  • 上传 endpoint 必须用 _api/web/getfolderbyserverrelativeurl('/path')/files/add(url='a.xml',overwrite=true),不能省略 url= 参数
fetch("https://contoso.sharepoint.com/_api/web/getfolderbyserverrelativeurl('/sites/demo/Shared%20Documents')/files/add(url='settings.xml',overwrite=true)", {
  method: "POST",
  headers: {
    "Accept": "application/json;odata=verbose",
    "X-RequestDigest": digest,
  },
  body: xmlBlob // Blob 对象,内容为纯 XML 元素(无声明、无 BOM)
});

解析已上传的 XML 文件内容(CSOM + REST 混合)

SharePoint 不提供内置 XML 解析服务,所谓“解析”是指:读取文件内容 → 在客户端或服务端解析成对象。不能直接用 CSOM 的 ListItem 获取 XML 结构,必须先下载原始流。

ModelGate
ModelGate

一站式AI模型管理与调用工具

下载

CSOM 下载需注意:File.OpenBinaryStream() 返回的是 ClientResult,必须用 context.ExecuteQuery() 触发传输,且流不可重复读 —— 建议立即转成 stringXDocument

  • 若 XML 含中文,务必用 Encoding.UTF8.GetString(streamBytes),不要依赖默认编码(可能为 ASCII 导致乱码)
  • REST 获取文件内容用 _api/web/getfilebyserverrelativeurl('/path.xml')/$value,响应是 raw binary,前端需用 response.arrayBuffer() 转换,再用 new TextDecoder().decode()
  • 避免在浏览器中直接用 DOMParser 解析含命名空间或 CDATA 的 XML,推荐用 fast-xml-parser 或服务端 System.Xml.Linq.XDocument
var file = context.Web.GetFileByServerRelativeUrl("/sites/demo/Shared Documents/config.xml");
var stream = file.OpenBinaryStream();
context.ExecuteQuery();
using (var reader = new StreamReader(stream.Value, Encoding.UTF8))
{
    string xmlText = reader.ReadToEnd();
    var doc = XDocument.Parse(xmlText); // 可靠解析
}

常见失败原因和绕过方式

很多“上传失败”或“解析为空”其实和代码无关,而是 SharePoint 的安全策略在起作用:

  • 404 Not Found on /files/add:检查 URL 中的文档库路径是否正确,Shared Documents 在现代站点中实际 URL 是 Shared%20Documents,空格未编码会导致 404
  • 403 Forbidden on XML upload:确认租户级策略未禁用 XML(PowerShell 查:Get-SPOTenant | Select DisableCustomScript;若为 True,需等 24 小时生效或联系管理员)
  • 下载后 XML 内容变成 HTML 错误页:说明文件被 SharePoint 当作可执行内容拦截,此时只能改文件扩展名(如 .xml.txt)再上传,解析前手动截掉后缀
  • CSOM 中 ExecuteQuery()Microsoft.SharePoint.Client.ServerUnauthorizedAccessException:不是权限不足,而是 App-Only 权限未包含 Files.ReadWrite.All(而非仅 Sites.Read.All

XML 文件在 SharePoint 里只是容器,真正复杂的是权限、编码、MIME 策略和跨域上下文 —— 别在解析逻辑里花太多时间,先确保它能干净地传进去、取出来。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

523

2023.08.02

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1905

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2094

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1089

2024.11.28

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

248

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

305

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

361

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

AO3官网入口与中文阅读设置 AO3网页版使用与访问
AO3官网入口与中文阅读设置 AO3网页版使用与访问

本专题围绕 Archive of Our Own(AO3)官网入口展开,系统整理 AO3 最新可用官网地址、网页版访问方式、正确打开链接的方法,并详细讲解 AO3 中文界面设置、阅读语言切换及基础使用流程,帮助用户稳定访问 AO3 官网,高效完成中文阅读与作品浏览。

11

2026.02.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.1万人学习

AngularJS教程
AngularJS教程

共24课时 | 3.2万人学习

CSS教程
CSS教程

共754课时 | 26.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号