指定したアイテムの 1 つ以上のプロパティを設定します。
名前空間: ReportService2006
アセンブリ: ReportService2006 (ReportService2006.dll)
構文
'宣言
Public Sub SetProperties ( _
Item As String, _
Properties As Property() _
)
'使用
Dim instance As ReportingService2006
Dim Item As String
Dim Properties As Property()
instance.SetProperties(Item, Properties)
public void SetProperties(
string Item,
Property[] Properties
)
public:
void SetProperties(
String^ Item,
array<Property^>^ Properties
)
member SetProperties :
Item:string *
Properties:Property[] -> unit
public function SetProperties(
Item : String,
Properties : Property[]
)
パラメーター
- Item
型: System.String
ファイル名と拡張子を含む、アイテムの完全修飾 URL です。
- Properties
型: array<ReportService2006.Property[]
アイテムに設定するプロパティと値を定義する Property オブジェクトの配列です。
説明
次の表に、この操作に関連するヘッダーおよび権限の情報を示します。
SOAP ヘッダー |
(Out) ServerInfoHeaderValue |
必要な権限 |
メソッドの引数として Property オブジェクトを渡すことにより、アイテムに新しいユーザー定義のプロパティを作成できます。 アイテムからプロパティを削除するには、プロパティに空の値を設定します。 予約済みのプロパティは削除できません。 アイテムの予約済みプロパティの一覧については、「レポート サーバー アイテムのプロパティ」を参照してください。
SetProperties メソッドの呼び出し時に、指定したプロパティが存在しない場合は、プロパティが作成され、指定した値が設定されます。 プロパティが既に存在する場合は、値が上書きされます。 存在しないプロパティに空の値を設定しても、アイテムやそのプロパティには影響がありません。
エラーが発生すると、プロパティは設定されません。
Item="/" のときは rsOperationNotSupportedSharePointMode エラーが返されます。
使用例
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
class Sample
{
static void Main(string[] args)
{
ReportingService2006 rs = new ReportingService2006();
rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" +
"ReportService2006.asmx";
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 = "http://<Server Name>/Docs/Documents/" +
"AdventureWorks Sample Reports/Sales Order Detail.rdl";
try
{
rs.SetProperties(itemPath, props);
Console.WriteLine("New description set on item {0}.",
itemPath);
}
catch (SoapException ex)
{
Console.WriteLine(ex.Detail.OuterXml);
}
}
}
Imports System
Imports System.IO
Imports System.Text
Imports System.Web.Services
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2006()
rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" + _
"ReportService2006.asmx"
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 = "http://<Server Name>/Docs/" + _
"Documents/AdventureWorks Sample Reports/" + _
"Sales Order Detail.rdl"
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
End Class