Penzle.Net下載Penzle.Net源代碼下載

Penzle.Net

其他類別

v2.8.1

下載

Penzle .Net SDK

Penzle .NET SDK是一個庫，它允許開發人員輕鬆地與Penzle內容交付和內容管理API集成。該SDK專為想要從Penzle平台創建，更新和檢索內容的.NET開發人員而設計。

入門

要安裝Penzle .NET SDK，您可以使用以下選項：

在軟件包管理器控制台中運行以下命令：

 Install-Package Penzle.Net

在命令行中運行以下.NET CLI命令：

 dotnet add <your project> package Penzle.Net

用法

要從Penzle API中檢索內容，您將使用DeliveryPenzleClient類。該課程提供了從Penzle交付API中檢索內容的方法。您將使用ManagementPenzleClient類來創建，更新和刪除內容。

您可以使用具有DI/IOC的客戶端，也可以使用DI/IOC。

沒有DI/IOC

   var client = DeliveryPenzleClient
          . Factory
          (
              apiDeliveryKey : "<delivery_api_key>" ,
              ( api ) =>
              {
                  api . Environment = "<environment_name>" ;
                  api . Project = "<project_name>" ;
              }
          ) ;

與di/ioc

    public void ConfigureServices ( IServiceCollection services )
    {
	    services . AddPenzleClient ( Configuration ) ;
    }

    public class HomeController
    {
	    private IDeliveryPenzleClient client ;

	    public HomeController ( IDeliveryPenzleClient deliveryPenzleClient )
	    {
		    client = deliveryPenzleClient ;
	    }
    }

檢索數據

創建Penzle客戶端后，您可以從Penzle API中檢索數據：

    // Retrieving a single entry by ID
    var entry = await client . Entry . GetEntry < Author > ( < author_id > ) ;
  
    Console . WriteLine ( entry . Summary ) ; // => Penzle author.
    Console . WriteLine ( entry . Age ) ; // => 27.

創建一個強大的類型模型，該模型首先與您的數據模板兼容，然後再做其他任何操作。

 public sealed class Author
{
    public string Summary { get ; set ; }
    public int Age { get ; set ; }
}

如果您需要條目的系統數據，請在類中添加入口系統屬性。

 public sealed class Author
{
    public EntrySystem System { get ; init ; }
    public string Summary { get ; set ; }
    public int Age { get ; set ; }
}

基於您在Penzle項目中定義的內容類型， GetEntries返回了強大的對象的集合。您可以使用LINQ在返回內容之前過濾，對其進行過濾和轉換。

    // Use query builder to define request parameters.
    var query = QueryEntryBuilder . New
                . Where ( x => x . Summary . Contains ( "J" ) && x . Age >= 30 )
                . OrderBy ( x => x . Id )
                . Select ( x => new { x . Id , x . FirstName } ) ;
        
    var entries = await client . Entry . GetEntries < Author > ( query : query ) ;

  // Print the entries to the console.
    foreach ( var entry in entries )
    {
        // Print the entry system fields.
        Console . WriteLine ( value : $ "Summary { entry . Summary } " ) ;
        Console . WriteLine ( value : $ "Age: { entry . Age } " ) ;
    }

您可以在.NET 7控制台項目中找到完整的示例，該項目以“如何”方法為開發人員編寫。請訪問Penzle.net.GettingSted，以查看如何在控制台應用中使用各種方法的所有示例。

管理API

要在Penzle項目中創建，更新或刪除數據，您需要使用Penzle Management API。 Penzle .NET SDK提供了一個ManagementPenzleClient類，您可以用來與管理API進行交互：

   var client = ManagementPenzleClient
          . Factory
          (
              apiManagementKey : "<management_api_key>"
          ) ;

    // Create a new instance of the form entry.
    var author = new Author
    {
        Summary = "David Smith" ,
        Age = 20 ,
    } ;

    // Create a new instance of the entry.
    var medicalReleaseId = await client . Entry . CreateEntry ( author , CancellationToken . None ) ;