ReportingService2010.SetItemDefinition(String, Byte[], Property[]) 方法

定义

设置指定项的定义或内容。 此方法适用于ReportModelDatasetComponentResourceDataSource项类型。

public:
 cli::array <ReportService2010::Warning ^> ^ SetItemDefinition(System::String ^ ItemPath, cli::array <System::Byte> ^ Definition, cli::array <ReportService2010::Property ^> ^ Properties);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.Warning[] SetItemDefinition (string ItemPath, byte[] Definition, ReportService2010.Property[] Properties);
[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.SetItemDefinition : string * byte[] * ReportService2010.Property[] -> ReportService2010.Warning[]
Public Function SetItemDefinition (ItemPath As String, Definition As Byte(), Properties As Property()) As Warning()

参数

ItemPath
String

项的完全限定 URL,其中包括文件名(在 SharePoint 模式下,还有扩展名)。

Definition
Byte[]

要注册的项定义。

Properties
Property[]

一个 Property 对象的数组,该数组定义要为项设置的属性和属性值。

返回

一个 Warning 对象的数组,该数组说明在验证项定义或内容时出现的警告。

属性

注解

下表显示了有关此操作的标头和权限信息。

SOAP 标头用法 (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
本机模式所需权限 取决于项类型:

- Report, DataSet: UpdateReportDefinition
- Resource, Component: UpdateContent
- DataSource: UpdateContent
- Model: UpdateContent
SharePoint 模式所需权限 <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems>

参数的 ItemPath 长度不能超过 260 个字符;否则,将引发 SOAP 异常,错误代码 为 rsItemLengthExceeded

参数 ItemPath 不能为 null 或空,也不能包含以下保留字符: : ? ; @ & = + $ , \ * > < | . "。 可以使用 /) (正斜杠字符分隔文件夹的完整路径名称中的项目,但不能在文件夹名称的末尾使用它。

如果 ItemTypeReport,则 XML 数据由 报表定义语言定义。 如果 ItemTypeModel,则 XML 数据由 语义模型定义语言定义

更改项的定义或内容会修改项的 ModifiedByModifiedDateSize 属性。 属性 Description 不受影响。 项的执行设置和现有快照保持不变。

适用于