Umbraco uses Unique Document Identifiers (UDIs) to reference most object types, such as content, media, and members. A UDI contains all the metadata needed to retrieve an Umbraco object and is readable within text.
Example:
umb://document/4fed18d8c5e34d5e88cfff3a5b457bf2.
UDIs are commonly used in Umbraco’s querying and management APIs.
A UDI consists of three parts:
Scheme: umb://
– Identifies as an Umbraco UDI.
Type: document
– Specifies the object type (for example, media, member, Data Type, and so on).
GUID Identifier: 4fed18d8c5e34d5e88cfff3a5b457bf2
– A unique identifier for the object (a GUID without dashes).
UDIs are useful for retrieving content, media, or other Umbraco objects through the API. Below are examples of how to use a UDI in C# to get content or media.
Retrieving Content by UDIYou can retrieve a content item using IContentService
:
using Umbraco.Cms.Core.Services;
using Umbraco.Cms.Core.Models
@inject IContentService contentService
@{
// Define the UDI string here
var udiString = "umb://document/334cadfa62dd49049aad86b6e4c02aac"; // Example UDI string
if (udiString.StartsWith("umb://document/"))
{
// Extract the GUID from the UDI string
var guidString = udiString.Replace("umb://document/", "");
if (Guid.TryParse(guidString, out var guid))
{
// Retrieve the content by GUID
var content = contentService.GetById(guid);
if (content != null)
{
// Access the body text field
var bodyText = content.GetValue<string>("bodyText"); // Replace 'bodyText' with the alias of your body text field
<p>@bodyText</p> // Output the body text
}
else
{
<p>Content not found.</p>
}
}
else
{
<p>Invalid GUID in the UDI string.</p>
}
}
}
There are two types of UDIs in Umbraco:
Used for objects that have a GUID identifier, such as content and media.
Used for objects that are not GUID-based, such as dictionary items.
Last updated 4 months ago
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4