DeleteOptionValueRequest Class

Definition

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

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

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

Public NotInheritable Class DeleteOptionValueRequest
Inherits OrganizationRequest

Inheritance

Object

OrganizationRequest

DeleteOptionValueRequest

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.

Delete a global choice option

/// <summary>
/// Demonstrates how to delete a global choice option
/// </summary>
/// <param name="service">Authenticated IOrganizationService instance</param>
/// <param name="value">The option value to remove</param>
/// <param name="globalChoiceName">The name of the global choice</param>
/// <param name="solutionUniqueName">The name of the solution to apply the change to</param>
static void DeleteGlobalChoiceValue(IOrganizationService service,
    int value,
    string globalChoiceName,
    string? solutionUniqueName
    )
{
    DeleteOptionValueRequest request = new()
    {
        Value = value,
        OptionSetName = globalChoiceName,
        SolutionUniqueName = solutionUniqueName
    };

    service.Execute(request);
}

Using this DeleteGlobalChoiceValue method:

DeleteGlobalChoiceValue(service, 152960002, "sample_test", "SolutionName");

Delete a local choice option

/// <summary>
/// Demonstrates how to delete a local choice option
/// </summary>
/// <param name="service">Authenticated IOrganizationService instance</param>
/// <param name="value">The option value to remove</param>
/// <param name="tableLogicalName">The logical name of the table that has the choice column.</param>
/// <param name="columnLogicalName">The logical name of the choice column</param>
/// <param name="solutionUniqueName">The name of the solution to apply the change to</param>
static void DeleteLocalChoiceValue(IOrganizationService service,
    int value,
    string tableLogicalName,
    string columnLogicalName,
    string? solutionUniqueName
    )
{
    DeleteOptionValueRequest request = new()
    {
        Value = value,
        EntityLogicalName = tableLogicalName,
        AttributeLogicalName = columnLogicalName,
        SolutionUniqueName = solutionUniqueName
    };

    service.Execute(request);
}        

Using this DeleteLocalChoiceValue method:

DeleteLocalChoiceValue(service, 152960002, "account", "sample_test", "SolutionName");

Sample code on GitHub

Work with choice columns

Remarks

For the Web API use the DeleteOptionValue action.

Usage

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

Privileges and Access Rights

To perform this action, the caller must have privileges included in the System Administrator or System Customizer security roles.

Notes for Callers

Use the OptionSetName property when working with global choices. For local option sets in a choice column, use the EntityLogicalName and AttributeLogicalName properties.

Constructors

Properties

Applies to