CloudTable.CreateIfNotExistsAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
CreateIfNotExistsAsync()
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync ();abstract member CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync () As Task(Of Boolean)Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
CreateIfNotExistsAsync(CancellationToken)
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (System.Threading.CancellationToken cancellationToken);abstract member CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
CreateIfNotExistsAsync(TableRequestOptions, OperationContext)
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext);abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext) As Task(Of Boolean)Parameters
- requestOptions
- TableRequestOptions
A TableRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, CancellationToken)
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput, System.Threading.CancellationToken cancellationToken);abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (indexingMode As IndexingMode, throughput As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- indexingMode
- IndexingMode
CosmosDB table indexing mode
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, CancellationToken)
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- requestOptions
- TableRequestOptions
A TableRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
CreateIfNotExistsAsync(IndexingMode, Nullable<Int32>, Nullable<Int32>, CancellationToken)
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput, int? defaultTimeToLive, System.Threading.CancellationToken cancellationToken);abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (indexingMode As IndexingMode, throughput As Nullable(Of Integer), defaultTimeToLive As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- indexingMode
- IndexingMode
CosmosDB table indexing mode
CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, Nullable<IndexingMode>, Nullable<Int32>, CancellationToken)
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, Microsoft.Azure.Cosmos.IndexingMode? indexingMode, int? throughput, System.Threading.CancellationToken cancellationToken);abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * Nullable<Microsoft.Azure.Cosmos.IndexingMode> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * Nullable<Microsoft.Azure.Cosmos.IndexingMode> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, indexingMode As Nullable(Of IndexingMode), throughput As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- requestOptions
- TableRequestOptions
- operationContext
- OperationContext
- indexingMode
- Nullable<IndexingMode>
- cancellationToken
- CancellationToken
Returns
Applies to
CreateIfNotExistsAsync(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>, CancellationToken)
Initiates an asynchronous operation to create a table if it does not already exist.
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions, Microsoft.Azure.Cosmos.Table.OperationContext operationContext, string serializedIndexingPolicy, int? throughput, int? defaultTimeToLive, System.Threading.CancellationToken cancellationToken);abstract member CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function CreateIfNotExistsAsync (requestOptions As TableRequestOptions, operationContext As OperationContext, serializedIndexingPolicy As String, throughput As Nullable(Of Integer), defaultTimeToLive As Nullable(Of Integer), cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- requestOptions
- TableRequestOptions
A TableRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- serializedIndexingPolicy
- String
CosmosDB table indexing policy.
CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task<TResult> object of type bool that represents the asynchronous operation.
Remarks
This API performs an existence check and therefore requires list permissions.
Applies to
Azure SDK for .NET
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for