Saintber.Extensions 1.0.0-rc02-alpha06

English Documentation | 中文說明

English Documentation

Overview

Saintber.Extensions is a collection of commonly used C# extension methods designed for the Saintber system architecture. It includes the following namespaces:

• DependencyInjection: Extension methods for dependency injection
• Linq: Utility extensions for LINQ operations
• Time: Extensions for time and timezone handling
• Transactions: Helpers for managing transactional workflows

Installation

dotnet add package Saintber.Extensions

📝 License

This package is licensed under the MIT License.

🌐 Repository

https://github.com/saintber/Saintber.Abstractions

Extension Library Overview

DependencyInjection

• ServiceCollectionExtensions - Provides extension methods for IServiceCollection
  • Register existing instances as specified interfaces (named registration)

Enum

• EnumExtensions - Provides extension methods for Enum operations
  • Try to parse a string to an enum member
  • Get the Description attribute of an enum member

Linq

• LinqExtensions - Provides extension methods for LINQ and Lambda operations
  • Asynchronous version of Select
  • ForEach supporting Lambda expressions
  • Asynchronous version of ForEach supporting Lambda expressions

Time

• DateTimeOffsetExtensions - Provides timezone conversion extension methods for DateTimeOffset
  • Convert DateTimeOffset to specified timezone
  • Support extracting user timezone from HTTP headers

Transactions

• TransactionExtensions - Provides extension methods for creating and controlling TransactionScope
  • Create standard transaction scopes with specified timeout and auto-commit behavior (supports async)

中文說明

簡介

Saintber.Extensions 是一組常用的 C# 擴充方法集合，設計於 Saintber 系統架構中，涵蓋以下命名空間：

• DependencyInjection：相依性注入相關擴充方法
• Linq：LINQ 操作的輔助擴充方法
• Time：時間與時區相關的擴充方法
• Transactions：交易流程輔助擴充方法

安裝方式

dotnet add package Saintber.Extensions

📝 許可條款

本套件採用 MIT 許可條款。

🌐 原始碼庫

https://github.com/saintber/Saintber.Extensions

擴充函式庫介紹

DependencyInjection

• ServiceCollectionExtensions - 提供 IServiceCollection 的擴充方法
  • 註冊現有實例為指定介面（具名註冊）

Enum

• EnumExtensions - 提供列舉函式操作的擴充方法
  • 嘗試將指定字串解析為列舉型別成員。
  • Description 屬性取得

Linq

• LinqExtensions - 提供 LINQ 與 Lambda 操作的擴充方法
  • 非同步版 Select
  • 支援 Lambda 表達式的 ForEach
  • 支援 Lambda 表達式的非同步版 ForEach

Time 命名空間

• DateTimeOffsetExtensions - 提供 DateTimeOffset 相關的時區轉換擴充方法
  • 將 DateTimeOffset 轉換為指定的時區時間
  • 支援從 HTTP Header 擷取使用者時區

Transactions 命名空間

• TransactionExtensions - 提供 TransactionScope 建立與控制的擴充方法
  • 建立具指定逾時與自動 Commit 行為的標準交易範圍（支援非同步）