ReportingService2005.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 <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())
Parâmetros
- Item
- String
O nome do caminho completo do item.
- Properties
- Property[]
Uma matriz de objetos Property que define as propriedades e os valores a serem definidos para o item.
Exemplos
Para compilar o exemplo de código a seguir, você deve referenciar o WSDL Reporting Services e importar determinados namespaces. Para obter mais informações, consulte Compilando e executando exemplos de código. O exemplo de código a seguir define uma nova descrição para o relatório Vendas da Empresa:
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);
}
}
}
Comentários
A tabela a seguir mostra o cabeçalho e as informações de permissão sobre esta operação.
Cabeçalhos SOAP | (In) BatchHeaderValue (Out) ServerInfoHeaderValue |
Permissões necessárias | Depende do tipo de item: - Folder : UpdateProperties- Report : UpdateProperties- Resource : UpdateProperties- DataSource : UpdateProperties- Model : UpdateProperties |
Você pode criar novas propriedades definidas pelo usuário para um item passando um Property objeto como um argumento de método. Para remover uma propriedade de um item, defina a propriedade como um valor vazio. Não é possível remover propriedades reservadas. Para obter uma lista de propriedades de item reservadas, consulte Propriedades do item do servidor de relatório.
Se uma propriedade especificada não existir quando o SetProperties método for chamado, a propriedade será criada e definida como o valor fornecido. Se a propriedade já existir, seu valor será substituído. Definir um valor vazio para uma propriedade que não existe não tem efeito sobre o item ou suas propriedades.
Se ocorrer um erro, nenhuma propriedade será definida.