ReportingService2010.SetItemDefinition(String, Byte[], Property[]) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
设置指定项的定义或内容。 此方法适用于Report
、Model
、Dataset
、Component
、Resource
和DataSource
项类型。
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[]
要注册的项定义。
返回
Warning[]
一个 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 或空,也不能包含以下保留字符: : ? ; @ & = + $ , \ * > < | . "
。 可以使用 /) (正斜杠字符分隔文件夹的完整路径名称中的项目,但不能在文件夹名称的末尾使用它。
如果 ItemType
为 Report
,则 XML 数据由 报表定义语言定义。 如果 ItemType
为 Model
,则 XML 数据由 语义模型定义语言定义。
更改项的定义或内容会修改项的 ModifiedBy、 ModifiedDate和 Size 属性。 属性 Description 不受影响。 项的执行设置和现有快照保持不变。