Compartilhar via


Parse (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna uma instância de geometry de uma representação WKT (Well-Known Text) do OGC (Open Geospatial Consortium). Parse() é equivalente a STGeomFromText(), com a exceção de que ele assume uma SRID (ID de referência espacial) igual a 0 como parâmetro. A entrada pode transportar valores opcionais Z (elevação) e M (medida).

Sintaxe

  
Parse ( 'geometry_tagged_text' )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

geometry_tagged_text
É a representação WKT da instância de geometry que você deseja retornar. geometry_tagged_text é uma expressão nvarchar.

Tipos de retorno

Tipo de retorno do SQL Server: geometry

Tipo de retorno do CLR: SqlGeometry

Comentários

O tipo do OGC da instância de geometry retornado por Parse() é definido como a entrada de WKT correspondente.

A cadeia de caracteres 'Null' será interpretada como uma instância de geometry nula.

Esse método gerará uma FormatException se a entrada não for bem formatada.

Exemplos

O exemplo a seguir usa Parse() para criar uma instância geometry.

DECLARE @g geometry;   
SET @g = geometry::Parse('LINESTRING (100 100, 20 180, 180 180)');  
SELECT @g.ToString();  

Consulte Também

STGeomFromText
Métodos estendidos de geometria estática