Azure AI Document Intelligence SDK for .NET. Extract text, tables, and structured data from documents using prebuilt and custom models. Use for invoice processing, receipt extraction, ID document analysis, and custom document models. Triggers: "Document Intelligence", "DocumentIntelligenceClient", "form recognizer", "invoice extraction", "receipt OCR", "document analysis .NET".
Documentation
Azure.AI.DocumentIntelligence (.NET)
Extract text, tables, and structured data from documents using prebuilt and custom models.
BLOB_CONTAINER_SAS_URL=https://<storage>.blob.core.windows.net/<container>?<sas-token> # Optional: blob container SAS URL for training data
AZURE_TOKEN_CREDENTIALS=prod # Required only if DefaultAzureCredential is used in production
using Azure.Identity;using Azure.AI.DocumentIntelligence;string endpoint = Environment.GetEnvironmentVariable("DOCUMENT_INTELLIGENCE_ENDPOINT");// Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>var credential = new DefaultAzureCredential( DefaultAzureCredential.DefaultEnvironmentVariableName);// Or use a specific credential directly in production:// See https://learn.microsoft.com/dotnet/api/overview/azure/identity-readme?view=azure-dotnet#credential-classes// var credential = new ManagedIdentityCredential();var client = new DocumentIntelligenceClient(new Uri(endpoint), credential);
string endpoint = Environment.GetEnvironmentVariable("DOCUMENT_INTELLIGENCE_ENDPOINT");string apiKey = Environment.GetEnvironmentVariable("DOCUMENT_INTELLIGENCE_API_KEY");var client = new DocumentIntelligenceClient(new Uri(endpoint), new AzureKeyCredential(apiKey));
using Azure.AI.DocumentIntelligence;Uri invoiceUri = new Uri("https://example.com/invoice.pdf");Operation<AnalyzeResult> operation = await client.AnalyzeDocumentAsync( WaitUntil.Completed, "prebuilt-invoice", invoiceUri);AnalyzeResult result = operation.Value;foreach (AnalyzedDocument document in result.Documents){ if (document.Fields.TryGetValue("VendorName", out DocumentField vendorNameField) && vendorNameField.FieldType == DocumentFieldType.String) { string vendorName = vendorNameField.ValueString; Console.WriteLine($"Vendor Name: '{vendorName}', confidence: {vendorNameField.Confidence}"); } if (document.Fields.TryGetValue("InvoiceTotal", out DocumentField invoiceTotalField) && invoiceTotalField.FieldType == DocumentFieldType.Currency) { CurrencyValue invoiceTotal = invoiceTotalField.ValueCurrency; Console.WriteLine($"Invoice Total: '{invoiceTotal.CurrencySymbol}{invoiceTotal.Amount}'"); } // Extract line items if (document.Fields.TryGetValue("Items", out DocumentField itemsField) && itemsField.FieldType == DocumentFieldType.List) { foreach (DocumentField item in itemsField.ValueList) { var itemFields = item.ValueDictionary; if (itemFields.TryGetValue("Description", out DocumentField descField)) Console.WriteLine($" Item: {descField.ValueString}"); } }}
Uri fileUri = new Uri("https://example.com/document.pdf");Operation<AnalyzeResult> operation = await client.AnalyzeDocumentAsync( WaitUntil.Completed, "prebuilt-layout", fileUri);AnalyzeResult result = operation.Value;// Extract text by pageforeach (DocumentPage page in result.Pages){ Console.WriteLine($"Page {page.PageNumber}: {page.Lines.Count} lines, {page.Words.Count} words"); foreach (DocumentLine line in page.Lines) { Console.WriteLine($" Line: '{line.Content}'"); }}// Extract tablesforeach (DocumentTable table in result.Tables){ Console.WriteLine($"Table: {table.RowCount} rows x {table.ColumnCount} columns"); foreach (DocumentTableCell cell in table.Cells) { Console.WriteLine($" Cell ({cell.RowIndex}, {cell.ColumnIndex}): {cell.Content}"); }}
Operation<AnalyzeResult> operation = await client.AnalyzeDocumentAsync( WaitUntil.Completed, "prebuilt-receipt", receiptUri);AnalyzeResult result = operation.Value;foreach (AnalyzedDocument document in result.Documents){ if (document.Fields.TryGetValue("MerchantName", out DocumentField merchantField)) Console.WriteLine($"Merchant: {merchantField.ValueString}"); if (document.Fields.TryGetValue("Total", out DocumentField totalField)) Console.WriteLine($"Total: {totalField.ValueCurrency.Amount}"); if (document.Fields.TryGetValue("TransactionDate", out DocumentField dateField)) Console.WriteLine($"Date: {dateField.ValueDate}");}
var adminClient = new DocumentIntelligenceAdministrationClient( new Uri(endpoint), new AzureKeyCredential(apiKey));string modelId = "my-custom-model";Uri blobContainerUri = new Uri("<blob-container-sas-url>");var blobSource = new BlobContentSource(blobContainerUri);var options = new BuildDocumentModelOptions(modelId, DocumentBuildMode.Template, blobSource);Operation<DocumentModelDetails> operation = await adminClient.BuildDocumentModelAsync( WaitUntil.Completed, options);DocumentModelDetails model = operation.Value;Console.WriteLine($"Model ID: {model.ModelId}");Console.WriteLine($"Created: {model.CreatedOn}");foreach (var docType in model.DocumentTypes){ Console.WriteLine($"Document type: {docType.Key}"); foreach (var field in docType.Value.FieldSchema) { Console.WriteLine($" Field: {field.Key}, Confidence: {docType.Value.FieldConfidence[field.Key]}"); }}
string classifierId = "my-classifier";Uri blobContainerUri = new Uri("<blob-container-sas-url>");var sourceA = new BlobContentSource(blobContainerUri) { Prefix = "TypeA/train" };var sourceB = new BlobContentSource(blobContainerUri) { Prefix = "TypeB/train" };var docTypes = new Dictionary<string, ClassifierDocumentTypeDetails>(){ { "TypeA", new ClassifierDocumentTypeDetails(sourceA) }, { "TypeB", new ClassifierDocumentTypeDetails(sourceB) }};var options = new BuildClassifierOptions(classifierId, docTypes);Operation<DocumentClassifierDetails> operation = await adminClient.BuildClassifierAsync( WaitUntil.Completed, options);DocumentClassifierDetails classifier = operation.Value;Console.WriteLine($"Classifier ID: {classifier.ClassifierId}");
string classifierId = "my-classifier";Uri documentUri = new Uri("https://example.com/document.pdf");var options = new ClassifyDocumentOptions(classifierId, documentUri);Operation<AnalyzeResult> operation = await client.ClassifyDocumentAsync( WaitUntil.Completed, options);AnalyzeResult result = operation.Value;foreach (AnalyzedDocument document in result.Documents){ Console.WriteLine($"Document type: {document.DocumentType}, confidence: {document.Confidence}");}
// Get resource detailsDocumentIntelligenceResourceDetails resourceDetails = await adminClient.GetResourceDetailsAsync();Console.WriteLine($"Custom models: {resourceDetails.CustomDocumentModels.Count}/{resourceDetails.CustomDocumentModels.Limit}");// Get specific modelDocumentModelDetails model = await adminClient.GetModelAsync("my-model-id");Console.WriteLine($"Model: {model.ModelId}, Created: {model.CreatedOn}");// List modelsawait foreach (DocumentModelDetails modelItem in adminClient.GetModelsAsync()){ Console.WriteLine($"Model: {modelItem.ModelId}");}// Delete modelawait adminClient.DeleteModelAsync("my-model-id");
using Azure;try{ var operation = await client.AnalyzeDocumentAsync( WaitUntil.Completed, "prebuilt-invoice", documentUri);}catch (RequestFailedException ex){ Console.WriteLine($"Error: {ex.Status} - {ex.Message}");}