Elasticsearch 系列（七）- 在ASP.NET Core中使用高級客戶端NEST來操作Elasticsearch

来源:https://www.cnblogs.com/xyh9039/p/18200453
-Advertisement-
Play Games

本章將和大家分享在ASP.NET Core中如何使用高級客戶端NEST來操作我們的Elasticsearch。 NEST是一個高級別的Elasticsearch .NET客戶端，它仍然非常接近原始Elasticsearch API的映射。所有的請求和響應都是通過類型來暴露的，這使得它非常適合快速上手 ...


本章將和大家分享在ASP.NET Core中如何使用高級客戶端NEST來操作我們的Elasticsearch。

NEST是一個高級別的Elasticsearch .NET客戶端，它仍然非常接近原始Elasticsearch API的映射。所有的請求和響應都是通過類型來暴露的，這使得它非常適合快速上手和運行。

在底層，NEST使用Elasticsearch.Net低級客戶端來發送請求和接收響應，使用並擴展了Elasticsearch.Net中的許多類型。這個低級客戶端本身仍然可以通過高級客戶端的 .LowLevel 屬性來暴露。

高級客戶端NEST官方文檔地址：https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/nest-getting-started.html

廢話不多說，首選我們來看一下Demo的目錄結構，如下所示：

本Demo的Web項目為ASP.NET Core Web 應用程式（目標框架為.NET 8.0） MVC項目。

ORM框架用的是SqlSugarScope，實體映射用的是AutoMapper，DI框架用的是Autofac。

高級客戶端NEST版本用的 7.12.1 ，和Elasticsearch的版本保持一致。

一、連接Elasticsearch

1、單節點連接

var settings = new ConnectionSettings(new Uri("http://example.com:9200"))
    .DefaultIndex("people");

var client = new ElasticClient(settings);

2、多節點連接

var uris = new[]
{
    new Uri("http://localhost:9200"),
    new Uri("http://localhost:9201"),
    new Uri("http://localhost:9202"),
};

var connectionPool = new SniffingConnectionPool(uris);
var settings = new ConnectionSettings(connectionPool)
    .DefaultIndex("people");

var client = new ElasticClient(settings);

二、調試（Debugging）

官方文檔：

https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/debug-information.html

https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/debug-mode.html

https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/logging-with-on-request-completed.html

在使用NEST開發Elasticsearch應用程式時，查看NEST生成併發送給Elasticsearch的請求以及Elasticsearch返回的響應信息是非常有價值的。

我們直接來看一個示例，核心代碼如下：

using System.Text;
using Microsoft.Extensions.Configuration;
using Nest;
using Elasticsearch.Net;

namespace TianYaSharpCore.Elasticsearch
{
    /// <summary>
    /// ElasticClient提供者
    /// NEST官方文檔：https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/nest-getting-started.html#nest-getting-started
    /// </summary>
    public class ElasticClientProvider : IElasticClientProvider
    {
        /// <summary>
        /// Linq查詢的官方Client（高級客戶端）
        /// </summary>
        public IElasticClient ElasticLinqClient { get; set; }

        /// <summary>
        /// Json查詢的官方Client（低級客戶端）
        /// </summary>
        public IElasticLowLevelClient ElasticJsonClient { get; set; }

        /// <summary>
        /// 構造函數
        /// </summary>
        public ElasticClientProvider(IConfiguration configuration)
        {
            /*
                var uris = new[]
                {
                    new Uri("http://localhost:9200"),
                    new Uri("http://localhost:9201"),
                    new Uri("http://localhost:9202"),
                }; 
            */
            var uris = configuration["ElasticsearchConfig:Uris"];
            var defaultIndex = configuration["ElasticsearchConfig:DefaultIndex"]; //預設索引庫名稱
            var uriList = uris?.Split(new char[] { ';', ',' }, StringSplitOptions.RemoveEmptyEntries)
                .ToList().ConvertAll(u => new Uri(u)) ?? new List<Uri>();
            if (uriList.Count <= 0)
            {
                uriList.Add(new Uri("http://localhost:9200"));
            }

            if (string.IsNullOrEmpty(defaultIndex))
            {
                defaultIndex = "defaultIndex";
            }

            var list = new List<string>();
            var connectionPool = new SniffingConnectionPool(uriList); //連接池
            var settings = new ConnectionSettings(connectionPool)
                //.BasicAuthentication("root", "123456")     //驗證賬號密碼登錄
                .RequestTimeout(TimeSpan.FromSeconds(30))  //請求超時 30s
                .DefaultFieldNameInferrer(fieldName => fieldName) //移除NEST將類型屬性名稱序列化為駝峰式命名的預設行為

                /* Debug調試開始 */
                // 請註意，啟用詳細的調試信息可能會對性能產生影響，並且可能會占用更多的記憶體來存儲額外的信息。
                // 因此，在生產環境中應該禁用它，只在開發或故障排除時啟用。
                // 在生產環境中排查問題時建議使用 RequestConfiguration() 以針對某個請求單獨禁用直接流處理以捕獲請求和響應的位元組。
                // 官方文檔：
                // https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/debug-mode.html
                // https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/debug-information.html
                // https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/logging-with-on-request-completed.html
                .EnableDebugMode() // 啟用詳細的調試信息（在生產環境中應該禁用它，只在開發或故障排除時啟用）

                //.DisableDirectStreaming() // 禁用直接流處理以捕獲請求和響應的位元組
                //.PrettyJson() // 返回格式化的JSON響應

                // 這個回調會在每次請求完成（無論成功還是失敗）時被調用
                .OnRequestCompleted(apiCallDetails =>
                {
                    // 如果您有複雜的日誌記錄需求，這是一個很好的地方來實現它們，因為您可以訪問到請求和響應的詳細信息。
                    // 根據您的具體需求，您可能需要在回調中執行更複雜的邏輯，比如記錄詳細的日誌、發送警報或執行其他業務邏輯。

                    // log out the request and the request body, if one exists for the type of request
                    if (apiCallDetails.RequestBodyInBytes != null)
                    {
                        list.Add(
                            $"{apiCallDetails.HttpMethod} {apiCallDetails.Uri} " +
                            $"{Encoding.UTF8.GetString(apiCallDetails.RequestBodyInBytes)}"); //請求體
                    }
                    else
                    {
                        list.Add($"{apiCallDetails.HttpMethod} {apiCallDetails.Uri}");
                    }

                    // log out the response and the response body, if one exists for the type of response
                    if (apiCallDetails.ResponseBodyInBytes != null)
                    {
                        list.Add($"Status: {apiCallDetails.HttpStatusCode}" +
                                 $"{Encoding.UTF8.GetString(apiCallDetails.ResponseBodyInBytes)}"); //響應體
                    }
                    else
                    {
                        list.Add($"Status: {apiCallDetails.HttpStatusCode}");
                    }
                })
                /* Debug調試結束 */

                .DefaultIndex(defaultIndex);

            ElasticLinqClient = new ElasticClient(settings);
            ElasticJsonClient = ElasticLinqClient.LowLevel; //高級客戶端 NEST 可以通過訪問客戶端上的 .LowLevel 屬性來獲取 Elasticsearch.Net 低級客戶端
        }
    }
}

其中 .EnableDebugMode() 表示啟用詳細的調試信息。請註意，啟用詳細的調試信息可能會對性能產生影響，並且可能會占用更多的記憶體來存儲額外的信息。因此，在生產環境中應該禁用它，只在開發或故障排除時啟用。在生產環境中排查問題時建議使用 RequestConfiguration() 以針對某個請求單獨禁用直接流處理以捕獲請求和響應的位元組。

其中 .OnRequestCompleted() 這個回調會在每次請求完成（無論成功還是失敗）時被調用。如果您有複雜的日誌記錄需求，這是一個很好的地方來實現它們，因為您可以訪問到請求和響應的詳細信息。根據您的具體需求，您可能需要在回調中執行更複雜的邏輯，比如記錄詳細的日誌、發送警報或執行其他業務邏輯。

需要註意的是，此處的 .EnableDebugMode() 配置是針對所有的請求都生效的。在生產環境中，您可能不希望為所有請求都禁用直接流傳輸，因為這樣做會由於在記憶體中緩存請求和響應位元組而產生性能開銷。

為此，可以針對每個請求單獨啟用 DisableDirectStreaming 功能，如下所示：

/// <summary>
/// 調試
/// </summary>
public async Task DebugInformationAsync()
{
    // 其中HotelDoc類為自定義酒店數據對應的ES文檔
    var searchResponse = await _elasticClientProvider.ElasticLinqClient.SearchAsync<HotelDoc>(s => s
        .RequestConfiguration(r => r
            // 官方文檔：https://www.elastic.co/guide/en/elasticsearch/client/net-api/7.17/logging-with-on-request-completed.html
            // 在生產環境中運行應用程式時，您可能不希望為所有請求都禁用直接流傳輸，因為這樣做會由於在記憶體中緩存請求和響應位元組而產生性能開銷。
            // 然而，在臨時需要時捕獲請求和響應可能是有用的，比如為了排查生產環境中的問題。
            // 為此，可以針對每個請求單獨啟用 DisableDirectStreaming 功能。
            // 利用此功能，可以在 OnRequestCompleted 中配置一個通用的日誌記錄機制，並僅在必要時記錄請求和響應信息。
            .DisableDirectStreaming() // 僅針對此請求禁用直接流
        )
        .From(0)
        .Size(2)
        .Query(q => q
                .Match(m => m
                .Field(f => f.city)
                .Query("上海")
                )
        )
    );

    // 每個響應都包含一個DebugInformation屬性
    // 訪問DebugInformation屬性來獲取調試信息
    string debugInfo = searchResponse.DebugInformation;
}

當你使用 Elasticsearch.Net 和 NEST 客戶端庫與 Elasticsearch 伺服器進行交互時，每個響應對象都包含一個 DebugInformation 屬性，該屬性提供了有關請求和響應的詳細信息，以幫助你進行調試和故障排除。通過配置 ConnectionSettings 和 RequestConfiguration 上的屬性，你可以控制哪些額外的信息被包含在調試信息中。這些控制可以針對所有請求統一設置，或者針對每個請求單獨設置。

具體來說：

  • ConnectionSettings：允許你在客戶端初始化時全局設置調試信息的詳細程度。例如，你可以決定是否包含請求正文、響應正文或是時間戳等信息。
  • RequestConfiguration：提供了更細粒度的控制，使得你能夠為特定的請求覆蓋全局設置，添加或移除某些調試信息項目。這意味著對於某個特別關註的請求，你可以增加更多的調試細節，而不影響其他請求的輸出。

最後我們來看一下 searchResponse.DebugInformation 輸出的具體內容，如下所示：

Valid NEST response built from a successful (200) low level call on POST: /hotel/_search?pretty=true&error_trace=true&typed_keys=true
# Audit trail of this API call:
 - [1] SniffOnStartup: Took: 00:00:00.2151884
 - [2] SniffSuccess: Node: http://localhost:9200/ Took: 00:00:00.2027398
 - [3] PingSuccess: Node: http://127.0.0.1:9200/ Took: 00:00:00.0043129
 - [4] HealthyResponse: Node: http://127.0.0.1:9200/ Took: 00:00:00.0943867
# Request:
{"from":0,"query":{"match":{"city":{"query":"上海"}}},"size":2}
# Response:
{
  "took" : 3,
  "timed_out" : false,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 83,
      "relation" : "eq"
    },
    "max_score" : 0.88342106,
    "hits" : [
      {
        "_index" : "hotel",
        "_type" : "_doc",
        "_id" : "36934",
        "_score" : 0.88342106,
        "_source" : {
          "id" : 36934,
          "name" : "7天連鎖酒店(上海寶山路地鐵站店)",
          "address" : "靜安交通路40號",
          "price" : 336,
          "score" : 37,
          "brand" : "7天酒店",
          "city" : "上海",
          "starName" : "二鑽",
          "business" : "四川北路商業區",
          "location" : "31.251433, 121.47522",
          "pic" : "https://m.tuniucdn.com/fb2/t1/G1/M00/3E/40/Cii9EVkyLrKIXo1vAAHgrxo_pUcAALcKQLD688AAeDH564_w200_h200_c1_t0.jpg",
          "suggestion" : [
            "7天酒店",
            "四川北路商業區"
          ]
        }
      },
      {
        "_index" : "hotel",
        "_type" : "_doc",
        "_id" : "38609",
        "_score" : 0.88342106,
        "_source" : {
          "id" : 38609,
          "name" : "速8酒店(上海赤峰路店)",
          "address" : "廣靈二路126號",
          "price" : 249,
          "score" : 35,
          "brand" : "速8",
          "city" : "上海",
          "starName" : "二鑽",
          "business" : "四川北路商業區",
          "location" : "31.282444, 121.479385",
          "pic" : "https://m.tuniucdn.com/fb2/t1/G2/M00/DF/96/Cii-TFkx0ImIQZeiAAITil0LM7cAALCYwKXHQ4AAhOi377_w200_h200_c1_t0.jpg",
          "suggestion" : [
            "速8",
            "四川北路商業區"
          ]
        }
      }
    ]
  }
}

# TCP states:
  Established: 162
  TimeWait: 14
  SynSent: 4
  CloseWait: 13
  LastAck: 1
  FinWait1: 1

# ThreadPool statistics:
  Worker: 
    Busy: 1
    Free: 32766
    Min: 12
    Max: 32767
  IOCP: 
    Busy: 0
    Free: 1000
    Min: 1
    Max: 1000

三、索引庫操作

對於索引庫操作本人更傾向於使用DSL語句去執行。高級客戶端 NEST 可以通過訪問客戶端上的 .LowLevel 屬性來獲取 Elasticsearch.Net 低級客戶端。

在某些場景下，低級客戶端非常有用，比如你已經有了代表你想發送請求的JSON，此時並不想將其轉換成Fluent API或對象初始化語法，又或者客戶端中存在一個可以通過發送字元串請求或匿名類型來規避的bug。

通過 .LowLevel 屬性使用低級客戶端意味著你可以兼得兩者之長：

  • 利用高級客戶端
  • 在合適的情況下使用低級客戶端，同時充分利用NEST中的所有強類型及其序列化器進行反序列化。

示例：

using Nest;
using Elasticsearch.Net;
using Elasticsearch.Net.Specification.IndicesApi;

namespace TianYaSharpCore.Elasticsearch
{
    /// <summary>
    /// ES幫助類
    /// </summary>
    public class ElasticsearchHelper : IElasticsearchHelper
    {
        /*
            1、高級客戶端 NEST 可以通過訪問客戶端上的 .LowLevel 屬性來獲取 Elasticsearch.Net 低級客戶端。

            2、在某些場景下，低級客戶端非常有用，比如你已經有了代表你想發送請求的JSON，此時並不想將其轉換成Fluent API或對象初始化語法，
               又或者客戶端中存在一個可以通過發送字元串請求或匿名類型來規避的bug。

            3、通過 .LowLevel 屬性使用低級客戶端意味著你可以兼得兩者之長：
                *利用高級客戶端
                *在合適的情況下使用低級客戶端，同時充分利用NEST中的所有強類型及其序列化器進行反序列化。
        */

        private readonly IElasticClientProvider _elasticClientProvider;
        public ElasticsearchHelper(IElasticClientProvider elasticClientProvider)
        {
            _elasticClientProvider = elasticClientProvider;
        }

        #region 索引庫操作

        /// <summary>
        /// 判斷某個索引庫是否存在
        /// </summary>
        /// <param name="indexName">索引庫名稱</param>
        /// <returns>返回true表示已存在</returns>
        public async Task<bool> IsIndexExistsAsync(string indexName)
        {
            ExistsResponse existsResponse = await _elasticClientProvider.ElasticLinqClient.Indices
                .ExistsAsync(indexName);
            return existsResponse.IsValid && existsResponse.Exists;
        }

        /// <summary>
        /// 創建索引庫
        /// </summary>
        /// <param name="indexName">索引庫名稱</param>
        /// <param name="dsl">用於創建索引庫的DSL語句</param>
        /// <returns>返回true表示創建索引庫成功</returns>
        public async Task<bool> CreateIndexAsync(string indexName, string dsl)
        {
            // 發送PUT請求到 Elasticsearch 創建索引  
            CreateIndexResponse createIndexResponse = await _elasticClientProvider.ElasticJsonClient.Indices
                .CreateAsync<CreateIndexResponse>(indexName, PostData.String(dsl));
            return createIndexResponse.IsValid && createIndexResponse.Acknowledged;
        }

        /// <summary>
        /// 創建索引庫
        /// </summary>
        /// <param name="indexName">索引庫名稱</param>
        /// <param name="body">請求數據</param>
        /// <returns>返回true表示創建索引庫成功</returns>
        public async Task<bool> CreateIndexAsync(string indexName, PostData body,
            CreateIndexRequestParameters requestParameters = null, CancellationToken ctx = default(CancellationToken))
        {
            // 發送PUT請求到 Elasticsearch 創建索引  
            CreateIndexResponse createIndexResponse = await _elasticClientProvider.ElasticJsonClient.Indices
                .CreateAsync<CreateIndexResponse>(indexName, body, requestParameters, ctx);
            return createIndexResponse.IsValid && createIndexResponse.Acknowledged;
        }

        /// <summary>
        /// 修改索引庫（註意：索引庫和mapping一旦創建無法修改，但是可以添加新的欄位。）
        /// </summary>
        /// <param name="indexName">索引庫名稱</param>
        /// <param name="dsl">用於修改索引庫的DSL語句</param>
        /// <returns>返回true表示修改索引庫成功</returns>
        public async Task<bool> PutMappingAsync(string indexName, string dsl)
        {
            PutMappingResponse putMappingResponse = await _elasticClientProvider.ElasticJsonClient.Indices
                .PutMappingAsync<PutMappingResponse>(indexName, PostData.String(dsl));
            return putMappingResponse.IsValid && putMappingResponse.Acknowledged;
        }

        /// <summary>
        /// 修改索引庫（註意：索引庫和mapping一旦創建無法修改，但是可以添加新的欄位。）
        /// </summary>
        /// <param name="indexName">索引庫名稱</param>
        /// <param name="body">請求數據</param>
        /// <returns>返回true表示修改索引庫成功</returns>
        public async Task<bool> PutMappingAsync(string indexName, PostData body,
            PutMappingRequestParameters requestParameters = null, CancellationToken ctx = default(CancellationToken))
        {
            PutMappingResponse putMappingResponse = await _elasticClientProvider.ElasticJsonClient.Indices
                .PutMappingAsync<PutMappingResponse>(indexName, body, requestParameters, ctx);
            return putMappingResponse.IsValid && putMappingResponse.Acknowledged;
        }

        /// <summary>
        /// 刪除索引庫
        /// </summary>
        /// <param name="indexName">索引庫名稱</param>
        /// <returns>返回true表示刪除索引庫成功</returns>
        public async Task<bool> DeleteIndexAsync(string indexName)
        {
            DeleteIndexResponse deleteIndexResponse = await _elasticClientProvider.ElasticLinqClient.Indices
                .DeleteAsync(indexName);
            return deleteIndexResponse.IsValid && deleteIndexResponse.Acknowledged;
        }

        #endregion

        #region 文檔操作

        /// <summary>
        /// 獲取文檔
        /// </summary>
        /// <typeparam name="TDocument">索引庫對應的文檔類型</typeparam>
        /// <param name="documentId">文檔Id</param>
        /// <returns></returns>
        public async Task<GetResponse<TDocument>> GetAsync<TDocument>(DocumentPath<TDocument> documentId,
            Func<GetDescriptor<TDocument>, IGetRequest> selector = null, CancellationToken ct = default(CancellationToken))
            where TDocument : class
        {
            return await _elasticClientProvider.ElasticLinqClient.GetAsync(documentId, selector, ct);
        }

        /// <summary>
        /// 新增文檔或全量修改文檔
        /// </summary>
        /// <typeparam name="TDocument">索引庫對應的文檔類型</typeparam>
        /// <param name="document">文檔</param>
        /// <returns>返回true表示操作成功</returns>
        public async Task<bool> IndexDocumentAsync<TDocument>(TDocument document, CancellationToken ct = de
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 阿裡也出手了！Spring CloudAlibaba AI問世了
    寫在前面 在之前的文章中我們有介紹過SpringAI這個項目。SpringAI 是Spring 官方社區項目，旨在簡化 Java AI 應用程式開發， 讓 Java 開發者想使用 Spring 開發普通應用一樣開發 AI 應用。 而SpringAI 主要面向的是國外的各種大模型接入，對於國內開發者可 ...
  • 【爬蟲軟體】批量爬取YouTube關鍵詞搜索結果，官方API實現！
    目錄一、背景介紹1.1 爬取目標1.2 演示視頻1.3 軟體說明二、代碼講解2.1 調用API-搜索介面2.2 調用API-詳情介面2.3 API_KEY說明2.4 軟體界面模塊2.5 日誌模塊三、轉載聲明 一、背景介紹 1.1 爬取目標 用Python獨立開發了一款爬蟲軟體，作用是：通過搜索關鍵詞 ...
  • 網卡-熱點搜索不到或者無法連接問題
    大屏設置網卡開啟熱點後，經常收到反饋，手機端無法搜索到大屏熱點、或者手機連接大屏熱點失敗 這類問題一般有以下幾類情況： 1. 物理網卡IP與熱點網卡IP相同 2. 熱點網卡IP，非正常熱點IP（192.168.137.X） 熱點IP我們一般定為192.168.137.X，192.168.137.X是 ...
  • C# 通過Win32API設置客戶端系統時間
    在日常工作中，有時可能會需要獲取或修改客戶端電腦的系統時間，比如軟體設置了Licence有效期，預計2024-06-01 00:00:00到期，如果客戶手動修改了客戶端電腦時間，往前調整了一年，則軟體就可以繼續使用一年，如此迴圈往複，則Licence將形同虛設。所以有時候需要校驗客戶端電腦時間和服務... ...
  • C# 設置PDF表單不可編輯、或提取PDF表單數據
    PDF表單是PDF中的可編輯區域，允許用戶填寫指定信息。當表單填寫完成後，有時候我們可能需要將其設置為不可編輯，以保護表單內容的完整性和可靠性。或者需要從PDF表單中提取數據以便後續處理或分析。 之前文章詳細介紹過如何使用免費Spire.PDF庫通過C# 創建、填寫表單，本文將繼續介紹該免費.NET ...
  • 如何更改.NET中的預設時區？
    除了"在操作系統中修改時區信息，然後重啟.NET應用程式，使其生效"之外。如何在不修改操作系統時區的前提下，修改.NET中的預設時區呢？ 這是一位 同學兼同事 於5月21日在技術群里問的問題，我當時簡單地研究了一下，就寫出來了。 現在寫文章分享給大家，雖然我覺得這種需求非常小眾，幾乎不會有人用到。 ...
  • gitlab自動定時備份文件，備份失敗發送郵件
    一、需求 為預防gitlab出現故障，每天定時備份，備份完成後把之前的備份文件刪除，備份成功或失敗的時候自動發送郵件提醒，這裡的gitlab為docker部署。 二、備份命令準備 1）備份命令 創建一個 gitlab_auto_backup.sh文件，文件內容 #!/bin/bash # 進入Git ...
  • c# 檢測密碼強度，評分規則仿google
    參考delphi的代碼更改為C# Delphi 檢測密碼強度 規則（仿 google） 仿 google 評分規則 一、密碼長度: 5 分: 小於等於 4 個字元 10 分: 5 到 7 字元 25 分: 大於等於 8 個字元 二、字母: 0 分: 沒有字母 10 分: 全都是小（大）寫字母 20 ...
一周排行
    -Advertisement-
    Play Games
  • 記一次 .NET某機械臂上位系統 卡死分析
    一：背景 1. 講故事 前些天有位朋友找到我，說他們的程式會偶發性的卡死一段時間，然後又好了，讓我幫忙看下怎麼回事？窗體類的程式解決起來相對來說比較簡單，讓朋友用procdump自動抓一個卡死時的dump，拿到dump之後，上 windbg 說話。 二：WinDbg 分析 1. 主線程在做什麼 要想 ...
  • C#控制項ListView支持添加TextBox\PictureBox等其他控制項
    功能說明 使用ListView時，希望可以在單元格顯示圖片或其他控制項，發現原生的ListView不支持，於是通過拓展，實現ListView可以顯示任意控制項的功能，效果如下： 實現方法 本來想著在單元格裡面實現控制項的自繪的，但是沒找到辦法，最後是通過在單元格的錶面顯示對應控制項的，浮於錶面達到目的。 實 ...
  • 【New Relic】給基於.NET Framework 4.0 的 exe 程式安裝New Relic
    由於.NET Framework 4.0 是比較古老的版本，只有New Relic 7.0以下的版本才會支持.NET Framework 4.0的引用程式。 Technical support for .NET Framework 4.0 or lower 你可以參考這個官方Install New ...
  • XAF 屬性編輯器（PropertyEditor）- 原理篇
    前言 隨著 DEV24.1.3 的發佈，XAF Blazor 中的屬性編輯器（PropertyEditor）也進行了很大的改動，在使用體驗上也更接近 WinForm 了，由於進行了大量的封裝，理解上沒有 WinForm 直觀，所以本文通過對屬性編輯器的原理進行解析，並對比新舊版本中的變化，使大家能夠 ...
  • 使用C#開發OPC UA伺服器
    OPC基金會提供了OPC UA .NET標準庫以及示常式序，但官方文檔過於簡單，光看官方文檔和示常式序很難弄懂OPC UA .NET標準庫怎麼用，花了不少時間摸索才略微弄懂如何使用，以下記錄如何從一個控制台程式開發一個OPC UA伺服器。 安裝Nuget包 安裝OPCFoundation.NetSt ...
  • dotnet 將本地的 Phi-3 模型與 SemanticKernel 進行對接
    今天在技術群里，石頭哥向大家提了個問題："如何在一個以System身份運行的.NET程式（Windows Services）中，以其它活動的用戶身份啟動可互動式進程（桌面應用程式、控制台程式、等帶有UI和互動式體驗的程式）"？ 我以前有過類似的需求，是在GitLab流水線中運行帶有UI的自動化測試程 ...
  • .NET 8 中的後臺服務：IHostedService 和 BackgroundService
    .Net 中提供了一系列的管理對象集合的類型，數組、可變列表、字典等。從類型安全上集合分為兩類，泛型集合 和 非泛型集合，傳統的非泛型集合存儲為Object，需要類型轉。而泛型集合提供了更好的性能、編譯時類型安全，推薦使用。 ...
  • 在Winform程式中動態繪製系統名稱，代替圖片硬編碼名稱
    在以前我做程式的時候，一般在登錄視窗裡面顯示程式名稱，登錄視窗一般設置一張背景圖片，由於程式的名稱一般都是確定的，所以也不存在太大的問題，不過如果客戶定製不同的系統的時候，需要使用Photoshop修改下圖層的文字，再生成圖片，然後替換一下也可以了。不過本著減少客戶使用繁瑣性，也可以使用空白名稱的通... ...
  • 聊一聊 Monitor.Wait 和 Pulse 的底層玩法
    一：背景 1. 講故事 在dump分析的過程中經常會看到很多線程卡在Monitor.Wait方法上，曾經也有不少人問我為什麼用 !syncblk 看不到 Monitor.Wait 上的鎖信息，剛好昨天有時間我就來研究一下。 二：Monitor.Wait 底層怎麼玩的 1. 案例演示 為了方便講述，先 ...
  • .NET-9-電腦思想-構建器模式(Builder Pattern)
    目錄前言學習參考過程總結: 前言 做個自由仔。 學習參考 ChatGpt; https://www.cnblogs.com/zhili/p/DesignPatternSummery.html(大佬的，看了好多次) 過程 原由： 一開始只是想查查鏈式調用原理，以為是要繼承什麼介面,實現什麼方法才可以實 ...
所有分類