SetItemDefinition 方法
設定指定之項目的定義或內容。這個方法會套用至 Report、Model、Dataset、Component、Resource 和 DataSource 項目類型。
命名空間: ReportService2010
組件: ReportService2010 (在 ReportService2010.dll 中)
語法
'宣告
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function SetItemDefinition ( _
ItemPath As String, _
Definition As Byte(), _
Properties As Property() _
) As Warning()
'用途
Dim instance As ReportingService2010
Dim ItemPath As String
Dim Definition As Byte()
Dim Properties As Property()
Dim returnValue As Warning()
returnValue = instance.SetItemDefinition(ItemPath, _
Definition, Properties)
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public Warning[] SetItemDefinition(
string ItemPath,
byte[] Definition,
Property[] Properties
)
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
public:
array<Warning^>^ SetItemDefinition(
String^ ItemPath,
array<unsigned char>^ Definition,
array<Property^>^ Properties
)
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/SetItemDefinition", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
member SetItemDefinition :
ItemPath:string *
Definition:byte[] *
Properties:Property[] -> Warning[]
public function SetItemDefinition(
ItemPath : String,
Definition : byte[],
Properties : Property[]
) : Warning[]
參數
- ItemPath
型別:System. . :: . .String
項目的完整 URL,包括檔案名稱以及 SharePoint 模式中的延伸模組。
- Definition
型別:array<System. . :: . .Byte> [] () [] []
要註冊的項目定義。
- Properties
型別:array<ReportService2010. . :: . .Property> [] () [] []
Property 物件的陣列,定義要為項目設定的屬性和值。
傳回值
型別:array<ReportService2010. . :: . .Warning> [] () [] []
Warning 物件的陣列,描述在驗證項目定義或內容時所發生的警告。
備註
The table below shows header and permissions information on this operation.
SOAP Header Usage |
(Out) ServerInfoHeaderValue |
Native Mode Required Permissions |
Depends on the item type:
|
SharePoint Mode Required Permissions |
EditListItems()()()() |
The length of the ItemPath parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.
The ItemPath parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.
If ItemType is Report, then the XML data is defined by the Report Definition Language. If ItemType is Model, then the XML data is defined by the Semantic Model Definition Language.
Changing the definition or content for an item modifies the ModifiedBy, ModifiedDate, and Size properties of the item. The Description property is not affected. Execution settings and existing snapshots remain unchanged for the item.