RetrieveAttributeRequest Class

Definition

public ref class RetrieveAttributeRequest sealed : Microsoft::Xrm::Sdk::OrganizationRequest

[System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/xrm/2011/Contracts")]
public sealed class RetrieveAttributeRequest : Microsoft.Xrm.Sdk.OrganizationRequest

[<System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/xrm/2011/Contracts")>]
type RetrieveAttributeRequest = class
    inherit OrganizationRequest

Public NotInheritable Class RetrieveAttributeRequest
Inherits OrganizationRequest

Inheritance

Object

OrganizationRequest

RetrieveAttributeRequest

Attributes

DataContractAttribute

Examples

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface instance.

The following RetrieveColumnDefinitionById and RetrieveColumnDefinitionByName static methods both return the definition for the Account.Name column.

/// <summary>
/// Retrieves a column definition by ID.
/// </summary>
/// <param name="service">Authenticated IOrganizationService instance</param>
static void RetrieveColumnDefinitionById(IOrganizationService service)
{
    Guid metadataId = new("a1965545-44bc-4b7b-b1ae-93074d0e3f2a");

    RetrieveAttributeRequest request = new()
    {
        MetadataId = metadataId
    };

    var response = (RetrieveAttributeResponse)service.Execute(request);

    OutputStringColumnData(response.AttributeMetadata);
}

/// <summary>
/// Retrieves a column definition by name
/// </summary>
/// <param name="service">Authenticated IOrganizationService instance</param>
static void RetrieveColumnDefinitionByName(IOrganizationService service) {
    string tableLogicalName = "account";
    string columnLogicalName = "name";

    RetrieveAttributeRequest request = new() { 
      EntityLogicalName = tableLogicalName,
      LogicalName = columnLogicalName
    };

    var response = (RetrieveAttributeResponse)service.Execute(request);

    OutputStringColumnData(response.AttributeMetadata);
}

// Writes details about string columns
static void OutputStringColumnData(AttributeMetadata attributeMetadata) {

    var columnDefinition = (StringAttributeMetadata)attributeMetadata;

    Console.WriteLine($"DisplayName:{columnDefinition.DisplayName.UserLocalizedLabel.Label}");
    Console.WriteLine($"MaxLength:{columnDefinition.MaxLength}");
}

Both RetrieveColumnDefinitionById and RetrieveColumnDefinitionByName static methods use the OutputStringColumnData method to write the following:

DisplayName:Account Name
MaxLength:160  

Sample code on GitHub

Work with attribute metadata

Remarks

Usage

Pass an instance of this class to the Execute(OrganizationRequest) method, which returns an instance of RetrieveAttributeResponse.

Privileges and Access Rights

Column schema information is available for all users.

Notes for Callers

You can use either the LogicalName or MetadataId properties to specify the column definition you want to retrieve.

Constructors

Properties

Applies to