ReportingService2005.SetProperties(String, Property[]) 메서드

정의

네임스페이스:

ReportService2005

어셈블리:

ReportService2005.dll

지정된 항목의 속성을 하나 이상 설정합니다.

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);

public void SetProperties (string Item, ReportService2005.Property[] Properties);

member this.SetProperties : string * ReportService2005.Property[] -> unit

Public Sub SetProperties (Item As String, Properties As Property())

매개 변수

Item

String

항목의 전체 경로 이름입니다.

Properties

Property[]

항목에 대해 설정할 속성과 값을 정의하는 Property 개체의 배열입니다.

예제

다음 코드 예제를 컴파일하려면 Reporting Services WSDL을 참조하고 특정 네임스페이스를 가져와야 합니다. 자세한 내용은 코드 예제 컴파일 및 실행을 참조하세요. 다음 코드 예제에서는 회사 판매 보고서에 대한 새 설명을 설정합니다.

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim props(0) As [Property]  
      Dim setProp As New [Property]()  
      setProp.Name = "Description"  
      setProp.Value = "Sales by quarter and product category."  
      props(0) = setProp  

      Dim itemPath As String = "/SampleReports/Company Sales"  

      Try  
         rs.SetProperties(itemPath, props)  
         Console.WriteLine("New description set on item {0}.", itemPath)  

      Catch ex As SoapException  
         Console.WriteLine(ex.Detail.OuterXml)  
      End Try  
   End Sub 'Main  
End Class 'Sample  

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      Property[] props = new Property[1];  
      Property setProp = new Property();  
      setProp.Name = "Description";  
      setProp.Value = "Sales by quarter and product category.";  
      props[0] = setProp;  

      string itemPath = "/SampleReports/Company Sales";   

      try  
      {  
         rs.SetProperties(itemPath, props);  
         Console.WriteLine("New description set on item {0}.", itemPath);  
      }  

      catch (SoapException ex)  
      {  
         Console.WriteLine(ex.Detail.OuterXml);  
      }  
   }  
}  

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.

SOAP 헤더	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
필요한 권한	항목 유형에 따라 다릅니다. - Folder: UpdateProperties - Report: UpdateProperties - Resource: UpdateProperties - DataSource: UpdateProperties - Model: UpdateProperties

개체를 메서드 인수로 전달 Property 하여 항목에 대한 새 사용자 정의 속성을 만들 수 있습니다. 항목에서 속성을 제거하려면 속성을 빈 값으로 설정합니다. 예약된 속성은 제거할 수 없습니다. 예약된 항목 속성 목록은 보고서 서버 항목 속성을 참조하세요.

메서드가 호출될 때 SetProperties 지정된 속성이 없으면 속성이 만들어지고 사용자가 제공한 값으로 설정됩니다. 속성이 이미 있는 경우 해당 값을 덮어씁니다. 존재하지 않는 속성에 대해 빈 값을 설정해도 항목이나 해당 속성에는 영향을 주지 않습니다.

오류가 발생하면 속성이 설정되지 않습니다.