Class PaginatedNameSuffixClient
- Namespace
- Crews.PlanningCenter.Api.People.V2020_07_22
- Assembly
- Crews.PlanningCenter.Api.dll
Client for interacting with NameSuffix collection resources.
public class PaginatedNameSuffixClient : PaginatedResourceClient<NameSuffix, NameSuffixResource, NameSuffixCollectionResponse, NameSuffixResponse>
- Inheritance
-
PaginatedResourceClient<NameSuffix, NameSuffixResource, NameSuffixCollectionResponse, NameSuffixResponse>PaginatedNameSuffixClient
- Inherited Members
Constructors
PaginatedNameSuffixClient(HttpClient, Uri)
Client for interacting with NameSuffix collection resources.
public PaginatedNameSuffixClient(HttpClient httpClient, Uri uri)
Parameters
httpClientHttpClienturiUri
Methods
AddCustomParameter(string, string)
Adds a custom query parameter to the request URI.
public PaginatedNameSuffixClient AddCustomParameter(string parameter, string value)
Parameters
Returns
- PaginatedNameSuffixClient
The current PaginatedNameSuffixClient instance.
ClearParameters()
Removes the entire query string from the request URI.
public PaginatedNameSuffixClient ClearParameters()
Returns
- PaginatedNameSuffixClient
The current PaginatedNameSuffixClient instance.
Filter(string)
Adds a filter query parameter to the request.
public PaginatedNameSuffixClient Filter(string filter)
Parameters
filterstringThe filter criteria.
Returns
- PaginatedNameSuffixClient
The current PaginatedNameSuffixClient instance.
Remarks
See Planning Center API documentation for details on supported filter values for this resource.
GetAsync(CancellationToken)
Fetches a paginated list of NameSuffix resources asynchronously.
public Task<NameSuffixCollectionResponse> GetAsync(CancellationToken cancellationToken = default)
Parameters
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<NameSuffixCollectionResponse>
A task representing the asynchronous operation, containing a paginated list of NameSuffix resources.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
Offset(int)
Sets the item offset in the paginated response.
public PaginatedNameSuffixClient Offset(int count)
Parameters
countintThe number of items to skip.
Returns
- PaginatedNameSuffixClient
The current PaginatedNameSuffixClient instance.
OrderByValue()
Sort response items by the Value attribute.
public NameSuffixClient OrderByValue()
Returns
OrderByValueDescending()
Sort response items by the Value attribute. Use reverse order.
public NameSuffixClient OrderByValueDescending()
Returns
PerPage(int)
Sets the number of items to be returned per page in the paginated response.
public PaginatedNameSuffixClient PerPage(int count)
Parameters
countintThe number of items to be returned per page.
Returns
- PaginatedNameSuffixClient
The current PaginatedNameSuffixClient instance.
PostAsync(NameSuffix, CancellationToken)
Creates a new NameSuffix resource asynchronously.
public Task<NameSuffixResponse> PostAsync(NameSuffix resource, CancellationToken cancellationToken = default)
Parameters
resourceNameSuffixThe resource data to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<NameSuffixResponse>
A task representing the asynchronous operation, containing the created NameSuffix resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
PostAsync(JsonApiDocument<NameSuffixResource>, CancellationToken)
Creates a new NameSuffix resource asynchronously.
public Task<NameSuffixResponse> PostAsync(JsonApiDocument<NameSuffixResource> document, CancellationToken cancellationToken = default)
Parameters
documentJsonApiDocument<NameSuffixResource>The JSON:API document to be sent in the POST request.
cancellationTokenCancellationTokenA token to monitor for cancellation requests.
Returns
- Task<NameSuffixResponse>
A task representing the asynchronous operation, containing the created NameSuffix resource.
Exceptions
- JsonApiException
Thrown when the HTTP response indicates a failure status code.
WhereValue(string)
Query response items by the Value attribute.
public NameSuffixClient WhereValue(string value)
Parameters
valuestring
Returns
WithId(string)
Creates a new instance of a NameSuffix client for a specific resource ID.
public NameSuffixClient WithId(string id)
Parameters
idstringThe ID of the resource to create a client for.
Returns
- NameSuffixClient
A new instance of the resource client for the specified resource ID.