ReportingService2005.SetProperties(String, Property[]) ReportingService2005.SetProperties(String, Property[]) ReportingService2005.SetProperties(String, Property[]) Method

정의

지정된 항목의 속성을 하나 이상 설정합니다. Sets one or more properties of a specified item.

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);
public void SetProperties (string Item, ReportService2005.Property[] Properties);
Public Sub SetProperties (Item As String, Properties As Property())
매개 변수
Item
String String String

항목의 전체 경로 이름입니다. The full path name of the item.

Properties
Property[]

배열 Property 속성 및 항목에 대해 설정할 값을 정의 하는 개체입니다. An array of Property objects that defines the properties and values to set for the item.

예제

다음 코드 예제를 컴파일하려면 Reporting Services WSDL 참조 하 고 특정 네임 스페이스를 가져올 해야 합니다.To compile the following code example, you must reference the Reporting Services WSDL and import certain namespaces. 자세한 내용은 참조 컴파일 및 코드 예제를 실행합니다.For more information, see Compiling and Running Code Examples. 다음 코드 예제에서는 Company Sales 보고서에 대 한 새 설명을 설정합니다.The following code example sets a new description for the Company Sales report:

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);  
      }  
   }  
}  

설명

다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.The table below shows header and permissions information on this operation.

SOAP 헤더SOAP Headers (In) BatchHeaderValue(In) BatchHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
필요한 권한Required Permissions 항목 형식에 따라 달라 집니다.Depends on the item type:

- Folder: UpdateProperties- Folder: UpdateProperties
- Report: UpdateProperties- Report: UpdateProperties
- Resource: UpdateProperties- Resource: UpdateProperties
- DataSource: UpdateProperties- DataSource: UpdateProperties
- Model: UpdateProperties- Model: UpdateProperties

전달 하 여 항목에 대 한 새 사용자 정의 속성을 만들 수 있습니다는 Property 메서드 인수로 개체입니다.You can create new user-defined properties for an item by passing a Property object as a method argument. 항목에서 속성을 제거 하려면 빈 값으로 속성을 설정 합니다.To remove a property from an item, set the property to an empty value. 예약 된 속성을 제거할 수 없습니다.You cannot remove reserved properties. 예약 된 항목 속성의 목록이 참조 보고서 서버 항목 속성합니다.For a list of reserved item properties, see Report Server Item Properties.

지정된 된 속성이 없는 경우 때는 SetProperties 메서드가 호출 되 면 속성 만들어지고 제공 하는 값으로 설정 합니다.If a specified property does not exist when the SetProperties method is called, the property is created and set to the value you supply. 속성에 이미 있으면 해당 값을 덮어씁니다.If the property already exists, its value is overwritten. 존재 하지 않는 속성에 대 한 빈 값을 설정 해도 항목 또는 해당 속성에는 영향이 없습니다.Setting an empty value for a property that does not exist has no effect on the item or its properties.

오류가 발생 하는 경우 속성이 설정 됩니다.If an error occurs, no properties are set.

적용 대상