Поделиться через


Метод 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

(In) TrustedUserHeaderValue

(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.