Cascade provides a straightforward method to retrieve specific individual models from your data origin.
Basic Usage
The primary method for retrieving a single model is the Get method. Here's how to use it:
public async Task<M> Get<M>(object id) where M : class
Parameters
- M: The type of model you're retrieving.
- id: The unique identifier of the model you want to fetch.
Return Value
The method returns a Task<M>, where M is the type of model you're retrieving.
Example Usage
Here's a simple example of how to use the Get method to retrieve a Docket:
public async Task<Docket> GetDocket(string docketId)
{
Docket docket = await AppCommon.Cascade.Get<Docket>(docketId);
return docket;
}
Null Results
If no model is found with the given ID, the Get method will return null.
Docket docket = await AppCommon.Cascade.Get<Docket>("non-existent-id");
if (docket == null)
{
Console.WriteLine("Docket not found");
}
Using Get with Different ID Types
The Get method can work with various ID types, depending on how your models are set up. For example:
User user = await AppCommon.Cascade.Get<User>("user123");
Product product = await AppCommon.Cascade.Get<Product>(42);
Best Practices
- Use Get when you need to retrieve a specific model and you know its ID.
- Always check for null results when using Get, especially if there's a possibility that the model might not exist.