ReportingService2006.SetProperties(String, Property[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define uma ou mais propriedades de um item especificado.
public:
void SetProperties(System::String ^ Item, cli::array <ReportService2006::Property ^> ^ Properties);
public void SetProperties(string Item, ReportService2006.Property[] Properties);
member this.SetProperties : string * ReportService2006.Property[] -> unit
Public Sub SetProperties (Item As String, Properties As Property())
Parâmetros
- Item
- String
A URL totalmente qualificada do item, incluindo o nome e extensão do arquivo.
- Properties
- Property[]
Um array de Property objetos que define as propriedades e valores a serem definidos para o item.
Exemplos
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
Comentários
A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.
| Cabeçalhos SOAP | (Em) TrustedUserHeaderValue (Fora) ServerInfoHeaderValue |
| Permissões necessárias | <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems> |
Você pode criar novas propriedades definidas pelo usuário para um item passando um Property objeto como argumento de método. Para remover uma propriedade de um item, defina a propriedade para um valor vazio. Você não pode remover propriedades reservadas. Para uma lista das propriedades dos itens reservados, veja Propriedades do Item do Servidor de Relatórios.
Se uma propriedade especificada não existir quando o SetProperties método for chamado, a propriedade é criada e definida para o valor que você fornece. Se a propriedade já existir, seu valor é sobrescrevido. Definir um valor vazio para uma propriedade que não existe não afeta o item nem suas propriedades.
Se ocorrer um erro, nenhuma propriedade é definida.
Retorna rsOperationNotSupportedSharePointMode erro quando Item="/".