DxListEditorBase<TData, TValue>.DisabledFieldName Property

Specifies the Boolean field that defines disabled states of component items.

Assembly: DevExpress.Blazor.v24.2.dll

Declaration

[DefaultValue("")]
[Parameter]
public string DisabledFieldName { get; set; }

Property Value

Type	Default	Description
String	String.Empty	The name of a data source field.

Remarks

You can disable individual items in list editors (ComboBox, List Box, TagBox). These items are grayed out and users can not select them. To disable items, set the DisabledFieldName property. This property specifies a Boolean field that stores each item’s enabled or disabled state.

Note

Disabled items can improve component usability, but cannot replace adequate security measures. Users may still be able to select disabled items on the client side, so you should implement appropriate security checks in your code.

@inject NwindDataService NwindDataService

<DxComboBox Data="@Products"
            @bind-Value="@SelectedProduct"
            NullText="Select a product without discount..."
            TextFieldName="@(nameof(Product.ProductName))"
            DisabledFieldName="@(nameof(Product.Discontinued))">
</DxComboBox>

@code {
    IEnumerable<Product> Products { get; set; }
    Product SelectedProduct { get; set; }
    protected override async Task OnInitializedAsync() {
        Products = await NwindDataService.GetProductsAsync();
        SelectedProduct = Products.FirstOrDefault();
    }
}

using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;

namespace BlazorDemo.Data.Northwind {
    public partial class Product {
        public Product() {
            OrderDetails = new HashSet<OrderDetail>();
        }
        public int ProductId { get; set; }
        public string ProductName { get; set; }
        public int? SupplierId { get; set; }
        public int? CategoryId { get; set; }
        public string QuantityPerUnit { get; set; }
        public decimal? UnitPrice { get; set; }
        public short? UnitsInStock { get; set; }
        public short? UnitsOnOrder { get; set; }
        public short? ReorderLevel { get; set; }
        public bool Discontinued { get; set; }
        public bool InStock => !Discontinued;
        public virtual Category Category { get; set; }
        public virtual Supplier Supplier { get; set; }
        public virtual ICollection<OrderDetail> OrderDetails { get; set; }
    }
}

using System.Collections.Generic;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using BlazorDemo.Data.Northwind;
using BlazorDemo.DataProviders;

namespace BlazorDemo.Services {
    public partial class NwindDataService {
        public Task<IEnumerable<Product>> GetProductsAsync(CancellationToken ct = default) {
            // Return your data here
        }
    }
}

using BlazorDemo.Services;
using Microsoft.Extensions.DependencyInjection;

public class Startup {
    public void ConfigureServices(IServiceCollection services) {
        // ...
        services.AddScoped<NwindDataService>();
    }
}

ComboBox - Disabled Items