Skip to main content

45 docs tagged with ".NET SDK"

View all tags

.NET SDK developer guide

Use the Temporal .NET SDK to develop Temporal Applications, connect to the Temporal Service, test Workflows and Activities, handle failures, send messages, and more.

Activities

Activity Definitions, Activity Execution, Timeouts, Standalone Activities, Dynamic Activities, and benign exceptions in the Temporal .NET SDK.

Activity basics

Define an Activity as a .NET method with the Activity attribute, give it a custom name, and keep argument Payloads inside the 2 MB and 4 MB gRPC limits.

Activity Execution

Call an Activity from a .NET Workflow with ExecuteActivityAsync, set the required Schedule-To-Close or Start-To-Close Timeout, and await the result.

Activity Timeouts

Set Activity Timeouts and a Retry Policy with the Temporal .NET SDK, override the next retry delay, and Heartbeat long-running Activities.

Asynchronous Activity Completion

Asynchronously complete an Activity in Temporal. Follow simple steps to allow an Activity Function to return without the Activity Execution completing.

Benign exceptions

Mark expected or non-severe Activity errors as benign in .NET to reduce noise in logs, metrics, and OpenTelemetry traces.

Best practices

This section explains how to implement best practices with the .NET SDK

Cancellation

Handle Cancellation in .NET Workflows and Activities, request Cancellation from a Client, and choose between Cancellation, termination, and reset.

Child Workflows

Start a Child Workflow Execution and set a Parent Close Policy using Temporal .NET SDK. Discover methods like ExecuteChildWorkflowAsync and manage Workflow behaviors.

Client

Connect a Temporal Client, start Workflow Executions, and get Workflow results with the Temporal .NET SDK.

Continue-As-New

Use Temporal's Continue-As-New in .NET to manage large Event Histories by atomically creating new Workflow Executions with the same Workflow Id and fresh parameters.

Data handling

Learn how Temporal handles data through the Data Converter, including payload conversion, encryption, and large payload storage.

Debugging

Debug Workflows in development and production environments using Temporal .NET SDK. Use logging, debugger, Web UI, CLI, replay, tracing, and more for efficient troubleshooting.

Dynamic Activity

Register one Dynamic Activity per Worker with Activity(Dynamic = true) to handle Activity Types that match no other registered Activity.

Interceptors

Implement Interceptors in the Temporal .NET SDK to manage inbound and outbound SDK calls, enhance tracing, and add authorization to your Workflows and Activities.

Nexus

This section explains how to use Temporal Nexus with the .NET SDK

Nexus feature guide

Use Temporal Nexus within the .NET SDK to connect Durable Executions within and across Namespaces using a Nexus Endpoint, a Nexus Service contract, and Nexus Operations.

Observability

Explore Temporal SDK observability features for Metrics, Tracing, Logging, and Visibility. Track Workflow Executions, set up Prometheus endpoints, customize metrics, configure tracing, and more.

Payload conversion

Customize how Temporal serializes application objects using Payload Converters in the .NET SDK.

Payload encryption

Encrypt data sent to and from the Temporal Service using a custom Payload Codec in the .NET SDK.

Platform

This section explains how to implement platform with the .NET SDK

Run a Worker

Create and run a Temporal Worker using the .NET SDK.

Schedules

Manage and optimize Scheduled Workflows using the Temporal .NET SDK; Schedule, Create, Backfill, Update, Delete, Describe, List, Pause, Trigger, and use Start Delay options.

Serverless Workers

Write Temporal Workers that run on serverless compute using the .NET SDK.

Temporal Client

Connect to a development Temporal Service or Temporal Cloud from .NET, set a Task Queue and Workflow Id, and get Workflow Execution results.

Testing

The .NET test-suite guide covers Workflow and integration testing for Temporal. It includes end-to-end, integration, and unit testing, emphasizing the use of the test server to optimize test execution.

Timers

Set a Durable Timer using the Temporal .NET SDK. Pause Workflow execution for days or months. Timers are persisted and highly resource-efficient using Workflow.DelayAsync.

Versioning

Use the .NET SDK Patching API to safely deploy new code versions, handle deprecated patches, and manage Workflow activities using Temporal for long-running tasks.

Workers

This section explains how to implement Workers with the .NET SDK

Workflow Streams

Workflow Streams in .NET supports typed events, Activity publishers, and subscriptions that retain offsets across Continue-As-New.

Workflow Timeouts

Optimize Workflow Execution with Temporal .NET SDK - Set Workflow Timeouts and Retry Policies efficiently.

Workflows

This section explains how to implement Workflows with the .NET SDK